andrew
2d7243332d
Move six scripts that are not wired into the app, scheduler, or web UI out of the active pipeline/lib into pipeline/lib/manual, so the scheduled scripts are easy to see and these stay available for hands-on use: convert-m4a.sh, fix-empty-album.sh, backfill-spotify-tags.sh, backfill-buy-url.py, recover-azuracast-playlists.py, import-dj-collection.py. Adds a README explaining each, and extends the Dockerfile chmod to cover the new folder. Nothing referenced these from active code (verified), so no wiring changes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Manual / archived scripts
These scripts are kept for occasional hands-on use but are not wired into
the app, the scheduler, or the web UI. Nothing here runs automatically. They
live outside pipeline/lib/ so the active, scheduled scripts there stay easy
to see at a glance.
Run one by hand inside the container when you actually need it, e.g.:
docker exec -it alembic bash /app/pipeline/lib/manual/convert-m4a.sh
docker exec -it alembic python /app/pipeline/lib/manual/import-dj-collection.py --help
What's here and why it's manual-only:
- convert-m4a.sh — one-off bulk M4A to FLAC/MP3 conversion. Not part of the normal download flow.
- fix-empty-album.sh — repairs tracks with an empty album tag. A cleanup tool for a specific past problem, not a recurring job.
- backfill-spotify-tags.sh — re-pulls Spotify tags for already-imported tracks. A migration/backfill aid.
- backfill-buy-url.py — one-time backfill of buy-link tags across the
library (the scheduled
enrich-buy-url.pyhandles new tracks going forward). - recover-azuracast-playlists.py — rebuilds AzuraCast playlist assignments after a GROUPING-tag loss. Recovery tool, only relevant if you run AzuraCast.
- import-dj-collection.py — bulk-imports a personal DJ set collection with fingerprint dedup against the existing library. A large one-off importer.
These have not all been hardened with set -euo pipefail; treat them as
run-and-watch tools rather than unattended automation.