Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NMLify

Turn a Spotify playlist into a Traktor crate (.nml) by fuzzy-matching every track against your local Traktor collection — and, optionally, against the audio files sitting on your disk.

Quick start

  1. Open the hosted app (link will appear here once the first GitHub Pages deploy lands — until then, follow the local-dev steps in web/README.md).
  2. Paste a Spotify playlist URL and click Fetch tracks. Public playlists load without any login. For a private or collaborative playlist you'll be redirected to Spotify to approve the app, then brought back with your playlist already loaded. NMLify ships with a built-in Client ID, so most users won't need to register anything.
  3. Pick your collection.nml, match, and click Download playlist. Drop the file into Traktor's Playlists section.

If Spotify rejects your login, the built-in app's developer-mode whitelist doesn't include you — expand Use my own Spotify developer app on the page and follow the short setup in web/README.md.

Self-host or hack on the web app

cd web
npm install
npm run dev      # http://127.0.0.1:5173/
npm test
npm run build

CI (typecheck + Vitest + Vite build) runs on every push and PR via .github/workflows/web.yml. Pushes to main also publish the built bundle to GitHub Pages.

Desktop / Python version

NMLify started life as a NiceGUI desktop app called CrateHacker. That original build still lives in desktop/ with its own install guide (desktop/INSTALL.md) and pytest suite. It's no longer the primary distribution, but it's there if you want a fully offline build or prefer the native UI.

License

MIT.

About

NMLify: Hack your nml crate

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages