dj-digger

About dj-digger

dj-digger is a free, open-source desktop app for crate digging, with a browser extension. Made by Filip Białogrecki.

How it works

Everything runs on your computer. There is no dj-digger server and no account.

How dj-digger worksA SoundCloud playlist goes into the dj-digger app on your computer. The app collects the whole list through SoundCloud's API, remembers your decisions in a local database and matches your music folders. It leads to store links sorted by store, such as Bandcamp, Beatport and Traxsource, to download gates on Hypeddit and ToneDen, and to copies exported for your decks.SoundCloud playlistYour computerdj-digger appCollects the whole listthrough SoundCloud's APIRemembers your decisionsin a local databaseMatches your music foldersso you see what you already ownStore linksBandcamp, Beatport, Traxsource and moreDownload gatesHypeddit, ToneDenYour deckscopies exported for your players

Downloads and carts

At a gate or a cart, the app sends each step to the extension, which works only in the tabs it opened.

The app and the extension at gates and cartsThe dj-digger app and the dj-digger extension are joined by native messaging, their only channel. The extension works only in tabs it opened: on SoundCloud it signs the app in, on Hypeddit and ToneDen it finishes the gate and the file goes to the app, on Bandcamp and Beatport it adds your picks to your cart. A tab heading for a checkout or payment page is closed; the cart tab is yours to review and pay.dj-digger appsends each stepNative messagingthe only channeldj-digger extensionworks only in tabs it openedSoundCloudsigns the app inHypeddit, ToneDenfinishes the gate, file to the appBandcamp, Beatportadds your picks to your cartCheckout or payment: tab closedCart tab: yours to review and pay

Where your data goes

Where the extension's data goesOne box, your computer, holds the dj-digger desktop app and your browser with the dj-digger extension. App and extension are joined by native messaging, their only channel. The only arrows that leave the box run from the tabs the extension opened for the app to five sites: Hypeddit, ToneDen, Bandcamp, Beatport and SoundCloud. A box for the developer stands outside with no arrow: nothing is sent there.Your computerdj-digger appsends the browser stepsNative messagingthe only channelYour browserdj-digger extensionTabs it openedfor the appDevelopernothing sentSitesHypedditToneDenBandcampBeatportSoundCloud

Your library, decisions and preferences stay on your computer. The extension talks only to the app, and nothing is sent to the developer.

The kick light

The player's light follows the kick drum. Its level is computed from the audio ahead of playback, and the light was checked frame by frame in the real window.

Mathilde Fernandez - Temple Sourire (Strenx & Lezguy Edit)

1:51 / 5:35
A recreation of the dj-digger player with a real track. Its artwork and waveform come from SoundCloud. Music: Mathilde Fernandez - Temple Sourire (Strenx & Lezguy Edit).

Credits and sources

dj-digger is open source under the Apache License 2.0.

Fonts
Archivo, Roboto Flex (Cyrillic) and JetBrains Mono, SIL Open Font License.
Icons
Phosphor Icons, MIT License.
Screenshots
The demo track in the app and extension screenshots is “Drift Away” by JMHBM (Johnathon M. Horner, Beat Mekanik), CC BY 4.0, via Free Music Archive.