Skip to main content

Uni V2 on Ubuntu Debugging

 "I've had the Uni for a few days now, and it works just great with Ubuntu. However, it doesn't work straight out of the box. There is a simple enough fix and only requires a one-line terminal command to get it working.

The issue is that, in order to read/write to a serial port (which is the protocol Gemini PR uses in Ubuntu), the user needs to be added to the dialout group. In theory, one could run Plover as a super user, but at least on my machine, Plover crashes for some reason when I try to run it with super user permissions, so I had to specifically change one permission for the regular user.

If none of this makes sense, that's okay. Here's a step-by-step on what to do to get the Uni working in Ubuntu, and you're welcome to re-publish it on your Guide page or your Blog. The command should, in theory, work in Arch Linux distros too, but I recommend testing that before saying so on your website.

1. Press CTRL + ALT + T to bring up the terminal.

2. Type the following line in the terminal from within any directory:

     sudo usermod -a -G dialout $USER

3. Log out of Ubuntu.

4. Log back in as the user you normally log in as.

5. Plug your Uni v2 into any USB port.

6. Open Plover.

7. Click on the Configure button.

8. Click on the Machine tab.

9. In the Machine dropdown menu, click on Gemini PR.

10. Click the Scan button in the Connection subgroup.

11. Click on the option* that shows up in the Port dropdown menu.

12. Click the OK button.

* If the device still doesn't work and there was more than one device in the Port dropdown menu, just keep trying different ones until it works.

One other thing is that, if you unplug the Uni and plug it back in, there's a chance it will switch ports. The easy way to fix that is to tell people to repeat steps 6 through 12 in order to get Plover to detect it again, with the additional step of clicking on Reconnect Machine in the File menu."

-Brownie McFinnigan


Popular posts from this blog

Uni Build Guide

How to Build Your Own Uni Step 1: Buy a PCB Go to  and buy yourself a PCB. Cool. You are done with this step. Step 2: Buy the other parts You need to buy these components: Pro Micro (or Pro Micro compatible Elite C) 28 PCB Mount* Switches (Mx, Alps, or Choc) 28  Keycaps  (You can also buy keycaps from other vendors) 4 Rubber Feet Solder and Soldering Iron USB Cable to connect your Uni to the computer *PCB mount switches have two additional plastic legs that makes it easier for the switches to stay on the PCB while you solder. Plate mount can work, but it will be harder. Alps switches are plate mount. Step 3: Solder the Pro-Micro Make sure to position the Pro-Micro on the side of the board WITHOUT diodes. It is also extremely important that you solder the pro micro on so that the smooth of the pro micro is facing up so that the footprints match up. The long pins face the pro micro wh

Debugging Tips For The Uni

 If your keyboard does not work, there are a few things that you can do. 1. Check that the cable you are using is a data cable. 2. Quit plover and run it again. 3. Go to configure > machine then click Gemini PR. Click scan and try all the ports. 4. Make sure that plover is enabled. If you are using Linux, try looking at these steps by a customer.

Magnetic Cables: Why you need them

Magnetic cables are normal cable with the ends cut off. Here is an affiliate link to the exact model of magnetic cable that I use. The tip that plugs into your device is separate from the rest of the cable. The cable snaps on to the cable magnetically, so you can unplug your device without having to worry about it damaging the port on the device. This is perfect for devices like keyboards, especially if its a device like the Uni v2 where the port is a micro-usb on a pro micro. You leave the little tip inside the device and snap the cable on and off without damaging the port. Verdict: Get them. Buy it here .