djayskee

A personal macOS companion for exploring a djay Pro music library.

djayskee was created by DJ Ole-Ole (Oleg Fomin) to analyze and work with his local djay Pro media library.

When preparing music for a set, I want to see context that djay Pro does not present in the analytical form I need: how often a track appeared in my DJ sets, how long ago I last played it, which playlists already contain it, whether it looks new or unused, and where its local file lives. djayskee brings those views together without modifying the djay library.

Features

• Browse all tracks, djay playlists, playlist folders, and connected local music folders.
• Search title and artist fragments across All Music or the current playlist/folder.
• Compare BPM, duration, artist, title, DJ-set frequency, recency, and playlist membership.
• Sort and resize every track column while keeping layout preferences between launches.
• Open the DJ sets and playlists containing a track and navigate directly to them.
• Inspect safe local-folder provenance without exposing absolute paths to the interface.
• Play local MP3 and M4A tracks with seeking, keyboard controls, and previous/next navigation.
• Refresh the library explicitly after djay Pro changes.
• Export a playlist's local files in djay order with optional order/BPM filename prefixes and an M3U playlist. Export works in the desktop app and macOS browser development mode, without overwriting existing files.
• Run in a standalone, native macOS window powered by Go, React, and Wails.

Requirements

djayskee runs on macOS 12 or newer and expects an existing djay Pro media library at its normal location. The application is currently built locally from source for the architecture of the build Mac; no downloadable binary is published.

Building requires:

• Go 1.25 or newer;
• Node.js ^20.19.0 or >=22.12.0 and npm;
• Xcode Command Line Tools.

Quick Start

git clone https://github.com/ofstudio/djayskee.git
cd djayskee
make deps
make install

make install runs the complete test and build pipeline, then installs the ad-hoc-signed application at:

~/Applications/djayskee.app

Running djayskee

Open djayskee.app from ~/Applications in Finder. You can also drag it to the Dock and launch it there like any other macOS application.

The installed app opens its own resizable window and reads the real local djay Pro library. Node.js, npm, and Vite are build-time tools only and are not needed while the app runs. The current local build is ad-hoc signed and is not notarized.

Development

Install dependencies once:

make deps

Useful workflows:

make dev          # Browser development with .local/djay.db
make dev-real     # Browser development with the real djay library
make dev-app      # Native Wails window with frontend hot reload
make test         # Go, frontend, and release-tool tests
make lint         # Go vet and frontend lint
make build        # Go and production frontend builds
make app          # Build .local/build/djayskee.app

The .local/ directory is ignored. Automated tests use synthetic fixtures and never depend on a personal library. Technical details are documented in Architecture, DJ-set analytics, UI guidelines, and djay schema notes.

Data Safety

djay's MediaLibrary.db, its .djayMediaLibrary package, connected music files, and djay preferences are immutable inputs. djayskee does not edit, move, or delete them.

License

Copyright 2026 Oleg Fomin.

Licensed under the Apache License 2.0.