An affordable, adorable, powerful hotkey device to run macros, play funny sounds, managing your audio settings, change paint brush settings, configuring items in OBS, and so much more!
(TODO: physical image here)
While this project is public, it is not ready for any sort of prime time. Any releases prior to 1.0 are considered beta.
TODO
Made with Rust and egui for Windows and Linux, curates the user experience with the JukeBox.
It's as simple as running cargo build --release.
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:
- Go to https://discord.com/developers/applications/ and log in with your account.
- Create a new application and name it JukeBoxDesktop.
- Go to the OAuth2 settings tab.
- Copy the client ID and client secret down to a safe location.
- Set the redirect to
https://localhost:61961. Save your changes. - Go to the App Testers settings tab.
- Add your Discord account as a tester. An email will be sent to your account email, go to your inbox and accept the invite.
- Build with the following command:
DISCORD_CLIENT_ID="<PUT_CLIENT_ID_HERE>" DISCORD_CLIENT_SECRET="<PUT_CLIENT_SECRET_HERE>" cargo run --features "discord" --release.
TODO
- (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"
- Install the appropriate target toolchain:
rustup target add thumbv6m-none-eabi. - Install cmake for tool compilation.
- (Linux only) Install libudev-dev:
sudo apt install libudev-dev. - Install tools:
cargo install flip-link. - Install tools:
cargo install --locked probe-rs-tools. This is for installing firmware over Pico probe. - Run
cargo run -F "keypad"to install the keypad firmware to the connected device. You can use pedalpad or knobpad too.
Made with OpenSCAD 2025.03.31 (development snapshot), protects everything inside the JukeBox. You can get the printable STLs with the build.sh script.
Made with KiCad 8, the external brains of the JukeBox.
Footprints and models:
Estimated power usage is 5 volts at 0.1 amps, or 0.5 watts.
| Ref | Part No. | Qty | Value |
|---|---|---|---|
| R1, R5, R14 | RMCF0402FT1K00 | 3 | 1k |
| R3, R4 | RMCF0402FT27R0 | 2 | 27 |
| R6, R7 | RMCF0402FT5K11 | 2 | 5.11k |
| R8-12, R15 | RMCF0402FT10K0 | 5 | 10k |
| R13 | RMCF0402FT10R0 | 1 | 10 |
| C1, C4 | GRM21BR61C106KE15K | 2 | 10u |
| C2, C3 | GCM1555C1H150JA16D | 2 | 15p |
| C5 | GRM155R71E104KE14J | 1 | 100n |
| C8, C10 | GRM155C81A105KA12D | 2 | 1u |
| D1-12 | 1N4148W-SOD-123 | 12 | |
| D13-24 | WS2812B-2020 | 12 | |
| D25 | 150080GS75000 | 1 | |
| J1 | USB4105-GF-A | 1 | |
| Q1 | S8050-SOT-23 | 1 | |
| U1 | AZ1117IH-3.3TRG1 | 1 | |
| U2 | W25Q128JVSIQ-TR | 1 | |
| U3 | RP2040 | 1 | |
| U4 | TFTQ-T20SH12ZP01 | 1 | |
| U5 | CAT24C512WI-GT3 | 1 | |
| Y1 | ABM8-272-T3 | 1 |
Copyright (c) 2020-2025 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.