QTPy-Knob

QT Py USB Media Knob using rotary encoder & neopixel ring

The QTPy-Knob features:

Media knob for volume up/down/mute with "qtpy-knob.py" CircuitPython program
Stylish design reminiscent of Griffin Powermate
Recessed USB-C connector to for safety
No screws needed for assembly
Only 3 wires needed to solder (none if you want to forgo LED lighting)
Reprogrammable for any USB macro key action via CircuitPython

A small video about it: https://www.youtube.com/watch?v=pt7JgoSlgOg

This is an attempt to make a minimal and easy-to-build version of similar, previous projects like:

Components

Parts needed:

Adafruit QT Py (Originally for QTPy M0 or XIAO SAMD21, but QTPy RP2040 does work via a fakerotaryio hack)
Adafruit Neopixel Ring (https://www.adafruit.com/product/1463 or equiv)
Rotary encoder (PEC11-4120F-S0018 or equiv. The 3D printed case expects encoder w/ 20mm shaft & 7mm threaded barrel, see here for mods if using a 15mm encoder)
3D printed enclosure (see "cad" folder)

Software

For some of the scripts and for some QT Py variants, there are prebuilt UF2 firmware images in Releases.

Otherwise, software installation consists of:

Install CircuitPython on the QT Py
Install required CircuitPython libraries to QT Py
Copy qtpy_knob.py to QT Py

The CircuitPython installation step is described here: https://learn.adafruit.com/welcome-to-circuitpython/installing-circuitpython

The last two steps can be accomplished with the below

git clone https://github.com/todbot/qtpy-knob
cd qtpy-knob
pip3 install circup
circup install -r requirements.txt
cp qtpy_knob.py /Volumes/CIRCUITPY/code.py

RP2040 NOTE: And if you have a QTPy RP2040, be sure to copy the "fakerotaryio.py" file to CIRCUITPY as well.

Variations

There are a few variations of the code provided:

qtpy_knob.py -- volume up / down and mute
qtpy_knob_scroller.py -- performs vertical & horizontal scrolling
qtpy_knob_midi_cc.py -- sends MIDI CC instead of keyboard/mouse
qtpy_knob_simple.py -- no neopixel stuff, just encoder and USB vol up/down sending

Assembly

Steps:

Plug rotary encoder to bottom of QT Py. If your encoder has metal on the bottom, add a bit of tape (Kapton, Scotch, electrical) in between the QT Py and the encoder. If your encoder has mounting tabs, cut them off. Solder the five pins.
Print out the enclosure on your 3d printer. Standard 0.2mm at 20% infill is fine. The STL files are:

qtpyknob-base.stl -- Base that houses the QT Py & rotary encoder
qtpyknob-basecap.stl -- Cap that goes on the bottom of the base
qtpyknob-knob.stl -- Knob that you turn
qtpyknob-diffuser.stl -- Light diffuser that goes between base & knob, should be printed with translucent or clear plastic. Or you can leave it out. Or you can approxiate it with a disk cut out clear plastic like a CD case

Use the rotary encoder's washer & screw to hold QTPy+encoder assembly

Solder three wires to the Neopixel ring, insert the ring into the enclosure and solder the wires to the 3V, Gnd, and MI pins of the QT Py. Use a bit of hot glue to secure the Neopixel ring if it doesn't snap in.
Snap the bottom cap on and the knob top on and you're done with physical assembly!

Wiring diagram

Assembly animation

Useful links

Resources that helped me out on this:

todbot / qtpy-knob

readme