New music analysis

.github/workflows/docs.yaml

@@ -39,7 +39,7 @@ jobs:
     - name: Setup pixi
       uses: prefix-dev/setup-pixi@v0.8.1
       with:
-        pixi-version: v0.69.0
+        pixi-version: v0.70.2
         # enable caching of installed envs
         cache: true
         # only write new caches on main pushes (TODO: Enable)

.github/workflows/tests.yaml

@@ -14,7 +14,7 @@ jobs:
       - name: Setup Pixi (installs pixi + caches envs) # https://github.com/marketplace/actions/setup-pixi
         uses: prefix-dev/setup-pixi@v0.9.3            # pin the action version
         with:
-          pixi-version: v0.69.0                       # pin the pixi binary version (optional)
+          pixi-version: v0.70.2                       # pin the pixi binary version (optional)
           cache: true                                 # enable caching of installed envs
           # only write new caches on main pushes (TODO: Enable)
           # cache-write: ${{ github.event_name == 'push' && github.ref_name == 'main' }}

.gitignore

@@ -30,6 +30,8 @@ openai_api_key.sh
 
 .cursor
 docs/ui-previews
+docs/specs/
+docs/superpowers
 test-results
 playwright-report
 web/dist
@@ -38,3 +40,10 @@ web/tsconfig.tsbuildinfo
 
 /log/
 /install/
+
+# all-in-one analysis byproducts
+/demix/
+/spec/
+
+CLAUDE.md
+memory

README.md

@@ -123,6 +123,23 @@ The system will automatically:
 - Ensure all movements stay within the configured flight boundaries
 - Synchronize drone movements with the musical timeline
 
+### Adding your own music
+
+The bundled tracks in `music/songs/` are already analyzed — their structure data lives in
+`music/analyzed/`, so they work out of the box. To add a song of your own:
+
+1. Drop the `.mp3` into `music/songs/`.
+2. Analyze it:
+   ```bash
+   pixi run -e music analyze
+   ```
+   This scans `music/songs/` and analyzes any track that doesn't yet have a cached result,
+   writing its structure to `music/analyzed/` and a visualization to `music/viz/`. Songs that
+   are already analyzed are skipped, so the command is safe to re-run. A CUDA GPU is strongly
+   recommended; analysis still runs on CPU but is much slower.
+
+The new song then shows up in the music library the next time you launch the interface.
+
 ### Ready for Deployment
 
 Once you're happy with your generated choreography, you can proceed to deploy it on your physical drone swarm.
@@ -154,3 +171,18 @@ us as follows:
   publisher={IEEE}
 }
 ```
+
+### Music analysis
+
+Song structure (beats, downbeats, and functional segments) is analyzed with the
+[All-In-One Music Structure Analyzer](https://github.com/mir-aidj/all-in-one) by Taejun Kim
+and Juhan Nam. If you use this project's music analysis, please also cite their work:
+
+```bibtex
+@inproceedings{taejun2023allinone,
+  title={All-In-One Metrical And Functional Structure Analysis With Neighborhood Attentions on Demixed Audio},
+  author={Kim, Taejun and Nam, Juhan},
+  booktitle={IEEE Workshop on Applications of Signal Processing to Audio and Acoustics (WASPAA)},
+  year={2023}
+}
+```