crateport

A DJ-focused playlist tool with two workflows:

• generate — build a playlist from a list of artists, albums, or tracks using the Deezer public API, then export it to XSPF / M3U / CSV / JSON. See docs/generate.md for details.
• convert — take a VirtualDJ CSV export, enrich every track with an ISRC via Deezer (falling back to MusicBrainz), and produce a Soundiiz-compatible CSV ready for import into Deezer or any other streaming platform. See docs/convert.md for details.

No Deezer application credentials required. API responses are cached locally in SQLite.

Requirements

• Python ≥ 3.14
• pipx for installation

Installation

git clone https://github.com/ZyanKLee/crateport.git
cd crateport
pipx install .

The crateport command is then available globally.

To upgrade after pulling new changes:

pipx install . --force

To uninstall:

pipx uninstall crateport

Working directory

crateport always reads and writes relative to where you run the command, regardless of where it is installed:

Quick start

# Convert a VirtualDJ set export to Soundiiz CSV with ISRC
crateport convert "source_data/2026-03-13 My Set.csv" --name "My_Set_2026-03-13"

# Generate a playlist from an artist list
crateport generate source_data/artists.txt --name "My Techno Mix"

Full command reference: docs/convert.md · docs/generate.md

Configuration

Copy .env.example to .env and adjust as needed. All values are optional.

cp .env.example .env

Contributing

See CONTRIBUTING.md for project structure and development setup.

License

MIT License © 2026 Zyan K. Lee