FAQ
Answers to your frequently asked questions.
General
What is djctl?
djctl tells you what’s playing on your Denon DJ device, Serato DJ Pro, or DJUCED software. When coupled with OBS or the djctl Twitch extension, it can be used to display a live updating overlay of what’s playing during your live stream DJ set.
How do you pronounce djctl?
It’s short for “DJ control” but any of the following are acceptable:
- DJ control
- DJ C-T-L
- DJ cuddle
What operating systems are supported?
djctl currently targets support for the following operating systems and platforms:
Operating System | Platform |
---|---|
darwin | amd64 |
darwin | arm64 |
linux | amd64 |
windows | amd64 |
It is technically possible for us to build executables that target other less mainstream operating system and platform combinations. The djctl project will work with the community to determine demand for alternative build targets.
Is there a graphical user interface (GUI) available?
No, djctl is a command line application only. There are no immediate plans to create a GUI.
How can I get support?
Please reach out to me via . Licensed users can also reach me through the private Discord server. (The link to this server is provided when a license is purchased.)
Denon
Which Denon devices work with djctl?
djctl has been tested and known to work with the following Denon hardware:
- Prime 4
Alpha testers have also tested the following devices and confirmed as working:
- Prime 4+
- Prime GO
The djctl project would like to test with other StagelinQ capable devices to confirm compatibility. Specifically, the following all-in-one devices may work but are unconfirmed:
- Prime 2
- Prime GO+
- SC Live 2 (w/USB to RJ45 adapter)
- SC Live 4 (w/USB to RJ45 adapter)
- Mixstream Pro (w/USB to RJ45 adapter)
- Mixstream Pro + (w/USB to RJ45 adapter)
- Mixstream Pro Go (w/USB to RJ45 adapter)
Experimental support is available for SC players paired with an X mixer. This includes the following equipment:
- SC5000
- SC5000M
- SC6000
- SC6000M
- X1800
- X1850
What is Denon StagelinQ?
StagelinQ is a proprietary communications protocol featured on select Denon DJ devices. Official Denon integrations with Resolume and SoundSwitch leverage this protocol.
djctl also uses this protocol, albeit a reverse-engineered implementation. Please see this Twitter thead along with this Denon DJ forum thread for all the nerdy details.
Does djctl support Denon controllers running in computer/USB mode?
Yes, djctl now provides experimental support for real-time Serato DJ Pro track detection. However, Virtual DJ is not supported.
How does djctl identify Denon track transitions?
For Denon sources, djctl supports a both a “volume” detection algorithm and a “lead” detection algorithm.
The “volume” algorithm promotes a track to “featured” state when it is the only audible track present in the mix. Other tracks that may have been playing during a transition must no longer be present in the mix. To prevent triggering premature track transitions during cuts or scratches, a user-definable delay timer can be configured.
The volume threshold that defines whether a track is still in the mix is configurable. When lowered from its default of 100%, a new track can be promoted to “featured” even with mixing styles that incorporate double drops or long transitions where the outgoing track faders remain partially up.
The “lead” algorithm follows the active play state on a deck. A track is lead if you press play and no other track is also in the play state. When you engage play on a new track, this new track doesn’t transition into lead state until the other track has been stopped.
Hercules
Which versions of Hercules DJUCED work with djctl?
djctl has been tested and known to work with the following DJUCED versions:
- 6.1.1 build d4003f1bb
Older versions may work but not have been explicitly verified.
Serato
Which versions of Serato DJ work with djctl?
djctl has been tested and known to work with the following Serato versions:
- Serato DJ Pro 3.2.4 (324532)
Older versions may work but not have been explicitly verified.
Serato track detection supports up to 2 decks. Unfortunately, 4 deck support is not possible at this time.
Serato DJ Lite is not supported.