Song Slicer

Purpose

Display the form of a piece of music by highlighting and labeling various regions. Assign colors and text to each region to show differences and similarities.

Dev setup

Requirements

• Node.js (tested with 23.x)
• Python 3 (3.10+ recommended)

Install

1. Run the first-time setup script:

npm run first-run

2. Run the app:

npm start

Windows first-run

If you're on Windows, you can run:

powershell -ExecutionPolicy Bypass -File scripts/first-run.ps1

Manual install (if you prefer)

1. Install Node dependencies:

npm install

2. Create a Python virtual environment and install Python deps:

python3 -m venv venv
./venv/bin/pip install -r requirements.txt

3. Run the app:

npm start

Windows manual install:

python -m venv venv
.\venv\Scripts\pip install -r requirements.txt

Python notes

• The app starts a local Flask server on port 5001 by default.
• You can override the Python interpreter with PYTHON=/path/to/python npm start.
• You can override the port with PY_SERVER_PORT=5001.

Troubleshooting

• ModuleNotFoundError: flask: install Python deps in the venv (./venv/bin/pip install -r requirements.txt or .\venv\Scripts\pip install -r requirements.txt on Windows).
• OSError: [Errno 48] Address already in use: another server is on port 5001. Stop it or change PY_SERVER_PORT.

Releases

This project uses Electron Forge for packaging.

Icons

• macOS: resources/icons/EAMIR.icns
• Windows: resources/icons/EAMIR.ico

Build

npm run make

Codesign + notarize (macOS)

./build-and-sign.sh runs the full macOS release flow (package, make, codesign, notarize, DMG).

1. Store credentials in Keychain (one time):

xcrun notarytool store-credentials "eamir-notary" \
  --apple-id "YOUR_APPLE_ID_EMAIL" \
  --team-id "YOUR_APPLE_TEAM_ID" \
  --password "YOUR_APP_SPECIFIC_PASSWORD"

2. Create a signing.env file (see signing.env.example) if you want to override the Keychain profile name.
3. If you're signing under your own Apple Developer account, update the signing identity in codesign-song-slicer.sh (TEAM_ID and IDENTITY) to match your certificate.
4. Run:

./build-and-sign.sh

Notes for signing yourself:

• Replace the Keychain profile by re-running notarytool store-credentials with your Apple ID/team and a new app-specific password.
• Update signing.env to point at your new NOTARY_PROFILE name if you changed it.

CSS

Using System.css project

• should be all set to be used offline. If there's gaps in the ui use the internet version with the link.
• Some icons used from https://iconoir.com/

Credits

Original authors:

• Vincent Boothroyd (@vboothroyd)
• Seth Frank (@sethbfrank)
• Gibson Phillips (@gibsonPhillips)

This project is now adapted and part of EAMIR, co-authored by V.J. Manzo (@vjmanzo)

License

Released under the AGPLv3 license. Original upstream components were released under the ISC License (see NOTICE).

Contributing

Navigate to the CONTRIBUTING.md file for guidelines on how to contribute to the project.