# Song import

1. **Scan** (already run once; run again if you add files to `songs/`; it overwrites the CSV, so save your edits under another name first):
   ```sh
   pip install mutagen
   python tools/scan_songs.py songs songs_manifest.csv
   ```
2. **Review** `songs_manifest.csv` in Excel:
   - `title`: required. Songs without a title are skipped.
   - `singers`: separate names with commas (`Gowtham, Bharathi`). It can stay empty; the app then shows "Singer not credited yet".
   - `occasion`: one of `huttu habba madhuvae devotional folk saavu instrumental`.
   - `include`: `yes` or `no`. Duplicates and the `old hits` folder (Tamil film songs) start as `no`.
   - `notes` says what needs a look. Save as **CSV UTF-8**.
3. **Check**: `python tools/import_songs.py --dry-run`
4. **Import** (the server must be running and the migrations applied):
   ```sh
   set NK_URL=https://app.nkbmusic.com
   set NK_SERVICE_KEY=<SERVICE_ROLE_KEY from the server .env>
   python tools/import_songs.py            # pending; add --approve to publish now
   ```
   Re-running skips songs already imported, so you can import in batches as you finish reviewing.