JukeBox

An affordable, adorable, powerful hotkey device to run macros, play funny sounds, managing your audio settings, change paint brush settings, configure items in OBS, and so much more!

Disclaimer

While this project is public, it is not ready for any sort of prime time. Any releases prior to 1.0 are considered beta.

Docs

TODO

Desktop Software

Made with Rust and egui for Windows and Linux, curates the user experience with the JukeBox.

Building

It's as simple as running cargo build --release.

Discord support

Discord, currently, will not provide support to new projects using their RPC protocol. Because of this, JukeBox Desktop will not support Discord out of the box, despite having functionality for it built in. To use the Discord functionality in JukeBox Desktop, you must do the following:

1. Go to https://discord.com/developers/applications/ and log in with your account.
2. Create a new application and name it JukeBoxDesktop.
3. Go to the OAuth2 settings tab.
4. Copy the client ID and client secret down to a safe location.
5. Set the redirect to https://localhost:61961. Save your changes.
6. Go to the App Testers settings tab.
7. Add your Discord account as a tester. An email will be sent to your account email, go to your inbox and accept the invite.
8. Build with the following command: DISCORD_CLIENT_ID="<PUT_CLIENT_ID_HERE>" DISCORD_CLIENT_SECRET="<PUT_CLIENT_SECRET_HERE>" cargo run --features "discord" --release.

Device Firmware

TODO

Building

1. (Linux only) Add yourself to the dialout group with the following: sudo usermod -a -G dialout $USER. Install the RPi Pico udev rules. Add the following rules:

SUBSYSTEM=="usb", \
    ATTRS{idVendor}=="2e8a", \
    ATTRS{idProduct}=="000c", \
    TAG+="uaccess" \
    MODE="660", \  
    GROUP="plugdev"

2. Install the appropriate target toolchain: rustup target add thumbv6m-none-eabi.
3. Install cmake for tool compilation.
4. (Linux only) Install libudev-dev: sudo apt install libudev-dev.
5. Install tools: cargo install flip-link.
6. Install tools: cargo install --locked probe-rs-tools. This is for installing firmware over Pico probe.
7. Run cargo run -F "keypad" to install the keypad firmware to the connected device. You can use pedalpad or knobpad too.

Case

Made with OpenSCAD 2025.03.31 (development snapshot), protects everything inside the JukeBox. You can get the printable STLs with the build.sh script.

PCB

Made with KiCad 10, the external brains of the JukeBox.

Footprints and models:

• Cherry/Kailh Switch footprint based on this.

Estimated power usage is 5 volts at 0.1 amps, or 0.5 watts.

Bill of Materials

License

Copyright (c) 2020-2026 Logan "NotQuiteApex" Hickok-Dickson

All programming files, found in firmware/, software/, and case/, are licensed under the MIT license.

All CAD files, found in hardware-pcb/, unless otherwise provided by an external source such as footprints or 3D models, are licesned under the CC BY-NC-SA license.

Both licenses can be found with the given links or as files in the root of this repostiory.

If you would like to sell a variation of the board designed by you, reach out and an alternative license can be discussed and granted.