HTXpunk Library Manager 0.1.0
© 2026 HTXpunk LLC
https://htxpunk.net

WHAT IT DOES
  Plans a clean VirtualDJ-style library from messy folders on your PC.
  Scan (local plan) → Identify (optional free AcoustID code) → Dry Run → Apply.
  Default Apply COPIES into your library and keeps originals.

REQUIREMENTS
  • Windows 10 or 11 (64-bit)
  • Python 3.11 or newer  — https://www.python.org/downloads/
    (Check "Add python.exe to PATH" when installing)

INSTALL (first time only)
  1. Unzip this folder anywhere (e.g. Documents\HTXpunk Library Manager)
  2. Double-click START.bat
  3. If Python is missing, install it, then run START.bat again
  4. First run creates a private Python environment (one-time, needs internet)

USE
  1. Browser opens to http://127.0.0.1:8000
  2. Complete "Song recognition setup" if you want Identify
     (free access code from AcoustID — guided in the app)
  3. Add source folders → Scan → review table → Dry Run → Apply

STOP
  Close the black START.bat window.

SAFETY
  • Runs only on this computer (127.0.0.1)
  • Your music is never uploaded for setup
  • Access codes stay in backend\.env on your machine
  • Do not share your backend\.env file

SUPPORT
  HTXpunk LLC — htxpunk.net

FREEMIUM
  Free: scan, plan, identify (your AcoustID code), copy/apply.
  Coming later: AI review, lyrics prep, virtual playlists.
