{"title":"","byline":null,"dir":null,"lang":null,"content":"

deej

\n

deej is an open-source hardware volume mixer for Windows and Linux PCs. It lets you use real-life sliders (like a DJ!) to seamlessly control the volumes of different apps (such as your music player, the game you're playing and your voice chat session) without having to stop what you're doing.

\n

Join the deej Discord server if you need help or have any questions!

\n

\"Discord\"

\n
\n

New: work-in-progress deej FAQ!

\n
\n

deej consists of a lightweight desktop client written in Go, and an Arduino-based hardware setup that's simple and cheap to build. Check out some versions built by members of our community!

\n

Download the latest release | Video demonstration | Build video by Tech Always

\n

\"deej\"

\n
\n

Psst! No 3D printer? No problem! You can build deej on some cardboard, a shoebox or even a breadboard :)

\n
\n

Table of contents

\n\n

Features

\n

deej is written in Go and distributed as a portable (no installer needed) executable.

\n
    \n
  • Bind apps to different sliders\n
      \n
    • Bind multiple apps per slider (i.e. one slider for all your games)
      • \n
    • Bind the master channel
      • \n
    • Bind \"system sounds\" (on Windows)
      • \n
    • Bind specific audio devices by name (on Windows)
      • \n
    • Bind currently active app (on Windows)
      • \n
    • Bind all other unassigned apps
      • \n
    \n
    • \n
  • Control your microphone's input level
    • \n
  • Lightweight desktop client, consuming around 10MB of memory
    • \n
  • Runs from your system tray
    • \n
  • Helpful notifications to let you know if something isn't working
    • \n
\n
\n

Looking for the older Python version? It's no longer maintained, but you can always find it in the legacy-python branch.

\n
\n

How it works

\n

Hardware

\n
    \n
  • The sliders are connected to 5 (or as many as you like) analog pins on an Arduino Nano/Uno board. They're powered from the board's 5V output (see schematic)
    • \n
  • The board connects via a USB cable to the PC
    • \n
\n

Schematic

\n

\"Hardware

\n

Software

\n
    \n
  • The code running on the Arduino board is a C program constantly writing current slider values over its serial interface
    • \n
  • The PC runs a lightweight Go client in the background. This client reads the serial stream and adjusts app volumes according to the given configuration file
    • \n
\n

Slider mapping (configuration)

\n

deej uses a simple YAML-formatted configuration file named config.yaml, placed alongside the deej executable.

\n

The config file determines which applications (and devices) are mapped to which sliders, and which parameters to use for the connection to the Arduino board, as well as other user preferences.

\n

This file auto-reloads when its contents are changed, so you can change application mappings on-the-fly without restarting deej.

\n

It looks like this:

\n
slider_mapping:\n  0: master\n  1: chrome.exe\n  2: spotify.exe\n  3:\n    - pathofexile_x64.exe\n    - rocketleague.exe\n  4: discord.exe\n\n# set this to true if you want the controls inverted (i.e. top is 0%, bottom is 100%)\ninvert_sliders: false\n\n# settings for connecting to the arduino board\ncom_port: COM4\nbaud_rate: 9600\n\n# adjust the amount of signal noise reduction depending on your hardware quality\n# supported values are \"low\" (excellent hardware), \"default\" (regular hardware) or \"high\" (bad, noisy hardware)\nnoise_reduction: default
\n
    \n
  • master is a special option to control the master volume of the system (uses the default playback device)
    • \n
  • mic is a special option to control your microphone's input level (uses the default recording device)
    • \n
  • deej.unmapped is a special option to control all apps that aren't bound to any slider (\"everything else\")
    • \n
  • On Windows, deej.current is a special option to control whichever app is currently in focus
    • \n
  • On Windows, you can specify a device's full name, i.e. Speakers (Realtek High Definition Audio), to bind that device's level to a slider. This doesn't conflict with the default master and mic options, and works for both input and output devices.\n
      \n
    • Be sure to use the full device name, as seen in the menu that comes up when left-clicking the speaker icon in the tray menu
      • \n
    \n
    • \n
  • system is a special option on Windows to control the \"System sounds\" volume in the Windows mixer
    • \n
  • All names are case-insensitive, meaning both chrome.exe and CHROME.exe will work
    • \n
  • You can create groups of process names (using a list) to either:\n
      \n
    • control more than one app with a single slider
      • \n
    • choose whichever process in the group that's currently running (i.e. to have one slider control any game you're playing)
      • \n
    \n
    • \n
\n

Build your own!

\n

Building deej is very simple. You only need a few relatively cheap parts - it's an excellent starter project (and my first Arduino project, personally). Remember that if you need any help or have a question that's not answered here, you can always join the deej Discord server.

\n

Build deej for yourself, or as an awesome gift for your gaming buddies!

\n

FAQ

\n

I've started a highly focused effort of writing a proper FAQ page for deej, covering many basic and advanced topics.

\n

It is still very much a work-in-progress, but I'm happy to share it in its current state in hopes that it at least covers some questions you might have.

\n

FAQ feedback in our community Discord is strongly encouraged :)

\n

Build video

\n

In case you prefer watching to reading, Charles from the Tech Always YouTube channel has made a fantastic video that covers the basics of building deej for yourself, including parts, costs, assembly and software. I highly recommend checking it out!

\n

Bill of Materials

\n
    \n
  • An Arduino Nano, Pro Micro or Uno board\n
      \n
    • I officially recommend using a Nano or a Pro Micro for their smaller form-factor, friendlier USB connectors and more analog pins. Plus they're cheaper
      • \n
    • You can also use any other development board that has a Serial over USB interface
      • \n
    \n
    • \n
  • A few slider potentiometers, up to your number of free analog pins (the cheaper ones cost around 1-2 USD each, and come with a standard 10K Ohm variable resistor. These should work just fine for this project)\n
      \n
    • Important: make sure to get linear sliders, not logarithmic ones! Check the product description
      • \n
    • You can also use circular knobs if you like
      • \n
    \n
    • \n
  • Some wires
    • \n
  • Any kind of box to hold everything together. You don't need a 3D printer for this project! It works fantastically with just a piece of cardboard or a shoebox. That being said, if you do have one, read on...
    • \n
\n

Thingiverse collection

\n

With many different 3D-printed designs being added to our community showcase, it felt right to gather all of them in a Thingiverse collection for you to browse. If you have access to a 3D printer, feel free to use one of the designs in your build.

\n

Visit our community-created design collection on Thingiverse!

\n
\n

You can also submit your own design to be added to the collection. Regardless, if you do upload your design to Thingiverse, please add a deej tag to it so that others can find it more easily.

\n
\n

Build procedure

\n
    \n
  • Connect everything according to the schematic
    • \n
  • Test with a multimeter to be sure your sliders are hooked up correctly
    • \n
  • Flash the Arduino chip with the sketch in arduino\\deej-5-sliders-vanilla\n
      \n
    • Important: If you have more or less than 5 sliders, you must edit the sketch to match what you have
      • \n
    \n
    • \n
  • After flashing, check the serial monitor. You should see a constant stream of values separated by a pipe (|) character, e.g. 0|240|1023|0|483\n
      \n
    • When you move a slider, its corresponding value should move between 0 and 1023
      • \n
    \n
    • \n
  • Congratulations, you're now ready to run the deej executable!
    • \n
\n

How to run

\n

Requirements

\n

Windows

\n
    \n
  • Windows. That's it
    • \n
\n

Linux

\n
    \n
  • Install libgtk-3-dev, libappindicator3-dev and libwebkit2gtk-4.0-dev for system tray support. Pre-built Linux binaries aren't currently released, so you'll need to build from source. If there's demand for pre-built binaries, please let me know!
    • \n
\n

Download and installation

\n
    \n
  • Head over to the releases page and download the latest version's executable and configuration file (deej.exe and config.yaml)
    • \n
  • Place them in the same directory anywhere on your machine
    • \n
  • (Optional, on Windows) Create a shortcut to deej.exe and copy it to %APPDATA%\\Microsoft\\Windows\\Start Menu\\Programs\\Startup to have deej run on boot
    • \n
\n

Building from source

\n

If you'd rather not download a compiled executable, or want to extend deej or modify it to your needs, feel free to clone the repository and build it yourself. All you need is a Go 1.14 (or above) environment on your machine. If you go this route, make sure to check out the developer scripts.

\n

Like other Go packages, you can also use the go get tool: go get -u github.com/omriharel/deej. Please note that the package code now resides in the pkg/deej directory, and needs to be imported from there if used inside another project.

\n

If you need any help with this, please join our Discord server.

\n

Community

\n

\"Discord\"

\n

deej is a relatively new project, but a vibrant and awesome community is rapidly growing around it. Come hang out with us in the deej Discord server, or check out a whole bunch of cool and creative builds made by our members in the community showcase.

\n

The server is also a great place to ask questions, suggest features or report bugs (but of course, feel free to use GitHub if you prefer).

\n

Donations

\n

If you love deej and want to show your support for this project, you can do so using the link below. Please don't feel obligated to donate - building the project and telling your friends about it goes a very long way! Thank you very much.

\n

\"ko-fi\"

\n

Contributing

\n

Please see docs/CONTRIBUTING.md.

\n

License

\n

deej is released under the MIT license.

\n
","textContent":"deej\ndeej is an open-source hardware volume mixer for Windows and Linux PCs. It lets you use real-life sliders (like a DJ!) to seamlessly control the volumes of different apps (such as your music player, the game you're playing and your voice chat session) without having to stop what you're doing.\nJoin the deej Discord server if you need help or have any questions!\n\n\nNew: work-in-progress deej FAQ!\n\ndeej consists of a lightweight desktop client written in Go, and an Arduino-based hardware setup that's simple and cheap to build. Check out some versions built by members of our community!\nDownload the latest release | Video demonstration | Build video by Tech Always\n\n\nPsst! No 3D printer? No problem! You can build deej on some cardboard, a shoebox or even a breadboard :)\n\nTable of contents\n\nFeatures\nHow it works\n\nHardware\n\nSchematic\n\n\nSoftware\n\n\nSlider mapping (configuration)\nBuild your own!\n\nFAQ\nBuild video\nBill of Materials\nThingiverse collection\nBuild procedure\n\n\nHow to run\n\nRequirements\nDownload and installation\nBuilding from source\n\n\nCommunity\nLicense\n\nFeatures\ndeej is written in Go and distributed as a portable (no installer needed) executable.\n\nBind apps to different sliders\n\nBind multiple apps per slider (i.e. one slider for all your games)\nBind the master channel\nBind \"system sounds\" (on Windows)\nBind specific audio devices by name (on Windows)\nBind currently active app (on Windows)\nBind all other unassigned apps\n\n\nControl your microphone's input level\nLightweight desktop client, consuming around 10MB of memory\nRuns from your system tray\nHelpful notifications to let you know if something isn't working\n\n\nLooking for the older Python version? It's no longer maintained, but you can always find it in the legacy-python branch.\n\nHow it works\nHardware\n\nThe sliders are connected to 5 (or as many as you like) analog pins on an Arduino Nano/Uno board. They're powered from the board's 5V output (see schematic)\nThe board connects via a USB cable to the PC\n\nSchematic\n\nSoftware\n\nThe code running on the Arduino board is a C program constantly writing current slider values over its serial interface\nThe PC runs a lightweight Go client in the background. This client reads the serial stream and adjusts app volumes according to the given configuration file\n\nSlider mapping (configuration)\ndeej uses a simple YAML-formatted configuration file named config.yaml, placed alongside the deej executable.\nThe config file determines which applications (and devices) are mapped to which sliders, and which parameters to use for the connection to the Arduino board, as well as other user preferences.\nThis file auto-reloads when its contents are changed, so you can change application mappings on-the-fly without restarting deej.\nIt looks like this:\nslider_mapping:\n 0: master\n 1: chrome.exe\n 2: spotify.exe\n 3:\n - pathofexile_x64.exe\n - rocketleague.exe\n 4: discord.exe\n\n# set this to true if you want the controls inverted (i.e. top is 0%, bottom is 100%)\ninvert_sliders: false\n\n# settings for connecting to the arduino board\ncom_port: COM4\nbaud_rate: 9600\n\n# adjust the amount of signal noise reduction depending on your hardware quality\n# supported values are \"low\" (excellent hardware), \"default\" (regular hardware) or \"high\" (bad, noisy hardware)\nnoise_reduction: default\n\nmaster is a special option to control the master volume of the system (uses the default playback device)\nmic is a special option to control your microphone's input level (uses the default recording device)\ndeej.unmapped is a special option to control all apps that aren't bound to any slider (\"everything else\")\nOn Windows, deej.current is a special option to control whichever app is currently in focus\nOn Windows, you can specify a device's full name, i.e. Speakers (Realtek High Definition Audio), to bind that device's level to a slider. This doesn't conflict with the default master and mic options, and works for both input and output devices.\n\nBe sure to use the full device name, as seen in the menu that comes up when left-clicking the speaker icon in the tray menu\n\n\nsystem is a special option on Windows to control the \"System sounds\" volume in the Windows mixer\nAll names are case-insensitive, meaning both chrome.exe and CHROME.exe will work\nYou can create groups of process names (using a list) to either:\n\ncontrol more than one app with a single slider\nchoose whichever process in the group that's currently running (i.e. to have one slider control any game you're playing)\n\n\n\nBuild your own!\nBuilding deej is very simple. You only need a few relatively cheap parts - it's an excellent starter project (and my first Arduino project, personally). Remember that if you need any help or have a question that's not answered here, you can always join the deej Discord server.\nBuild deej for yourself, or as an awesome gift for your gaming buddies!\nFAQ\nI've started a highly focused effort of writing a proper FAQ page for deej, covering many basic and advanced topics.\nIt is still very much a work-in-progress, but I'm happy to share it in its current state in hopes that it at least covers some questions you might have.\nFAQ feedback in our community Discord is strongly encouraged :)\nBuild video\nIn case you prefer watching to reading, Charles from the Tech Always YouTube channel has made a fantastic video that covers the basics of building deej for yourself, including parts, costs, assembly and software. I highly recommend checking it out!\nBill of Materials\n\nAn Arduino Nano, Pro Micro or Uno board\n\nI officially recommend using a Nano or a Pro Micro for their smaller form-factor, friendlier USB connectors and more analog pins. Plus they're cheaper\nYou can also use any other development board that has a Serial over USB interface\n\n\nA few slider potentiometers, up to your number of free analog pins (the cheaper ones cost around 1-2 USD each, and come with a standard 10K Ohm variable resistor. These should work just fine for this project)\n\nImportant: make sure to get linear sliders, not logarithmic ones! Check the product description\nYou can also use circular knobs if you like\n\n\nSome wires\nAny kind of box to hold everything together. You don't need a 3D printer for this project! It works fantastically with just a piece of cardboard or a shoebox. That being said, if you do have one, read on...\n\nThingiverse collection\nWith many different 3D-printed designs being added to our community showcase, it felt right to gather all of them in a Thingiverse collection for you to browse. If you have access to a 3D printer, feel free to use one of the designs in your build.\nVisit our community-created design collection on Thingiverse!\n\nYou can also submit your own design to be added to the collection. Regardless, if you do upload your design to Thingiverse, please add a deej tag to it so that others can find it more easily.\n\nBuild procedure\n\nConnect everything according to the schematic\nTest with a multimeter to be sure your sliders are hooked up correctly\nFlash the Arduino chip with the sketch in arduino\\deej-5-sliders-vanilla\n\nImportant: If you have more or less than 5 sliders, you must edit the sketch to match what you have\n\n\nAfter flashing, check the serial monitor. You should see a constant stream of values separated by a pipe (|) character, e.g. 0|240|1023|0|483\n\nWhen you move a slider, its corresponding value should move between 0 and 1023\n\n\nCongratulations, you're now ready to run the deej executable!\n\nHow to run\nRequirements\nWindows\n\nWindows. That's it\n\nLinux\n\nInstall libgtk-3-dev, libappindicator3-dev and libwebkit2gtk-4.0-dev for system tray support. Pre-built Linux binaries aren't currently released, so you'll need to build from source. If there's demand for pre-built binaries, please let me know!\n\nDownload and installation\n\nHead over to the releases page and download the latest version's executable and configuration file (deej.exe and config.yaml)\nPlace them in the same directory anywhere on your machine\n(Optional, on Windows) Create a shortcut to deej.exe and copy it to %APPDATA%\\Microsoft\\Windows\\Start Menu\\Programs\\Startup to have deej run on boot\n\nBuilding from source\nIf you'd rather not download a compiled executable, or want to extend deej or modify it to your needs, feel free to clone the repository and build it yourself. All you need is a Go 1.14 (or above) environment on your machine. If you go this route, make sure to check out the developer scripts.\nLike other Go packages, you can also use the go get tool: go get -u github.com/omriharel/deej. Please note that the package code now resides in the pkg/deej directory, and needs to be imported from there if used inside another project.\nIf you need any help with this, please join our Discord server.\nCommunity\n\ndeej is a relatively new project, but a vibrant and awesome community is rapidly growing around it. Come hang out with us in the deej Discord server, or check out a whole bunch of cool and creative builds made by our members in the community showcase.\nThe server is also a great place to ask questions, suggest features or report bugs (but of course, feel free to use GitHub if you prefer).\nDonations\nIf you love deej and want to show your support for this project, you can do so using the link below. Please don't feel obligated to donate - building the project and telling your friends about it goes a very long way! Thank you very much.\n\nContributing\nPlease see docs/CONTRIBUTING.md.\nLicense\ndeej is released under the MIT license.\n","length":9482,"excerpt":"deej","siteName":null}