update readme
Hunter
Friday, May 8th, 2026 at 11:12 AM
35
36 mixapps are digital artifacts. immutable objects that can persist on-device, independant of platforms, contracts, and corporate whim.<br><br>
37
-when you share one with a friend, it's theirs.<br><br>
38 +once you share one with a friend, it's theirs.<br><br>
39
40 ## quickstart
-1. **load it**
- - add your audio files to the `/mix` directory, or use:
- - `./rip.py` to rip tracks from a physical CD
- - `./buy.py` to search for tracks to purchase (opens in iTunes on MacOS, <a href="https://song.link/i/1651294855">song.link</a> otherwise)
-
-2. **serve it**
- - run `./serve.py` to start a local server for testing. you can scan the QR code printed to your terminal to test the app from any device on your local network. while the server is running, you can:
- - **add new tracks** by dragging audio files onto the page
41 +1. **serve it**
42 + - run `./serve.py` to start a development server. while the server is running, you can:
43 + - **add new tracks** by moving audio files into the `/mix` directory, dragging them into the browser window, running `./rip.py` to rip tracks from a physical CD, or running `./buy.py` to buy tracks on iTunes
44 - **reorder tracks** by dragging them up or down in the list
45 - **delete tracks** with `shift + click`
46
-3. **build it**
47 +2. **build it**
48 - once you're happy with your mix, run `./build.py` and follow the interactive prompts to generate `manifest.json` and `service-worker.js`, which enable PWA installation and offline functionality.
49
-4. **ship it**
50 +3. **ship it**
51 - upload the entire project directory to any static web host with HTTPS support (GitHub Pages, Neocities, AWS S3, etc.)
52
-5. **share it**
53 +4. **share it**
54 - send the hosted URL to your recipient and walk them through the installation process:
55 - **iOS (Safari)**: tap `···` → `Share` → `View More` → scroll down to reveal and tap `Add to Home Screen` → `Add`
56 - **Android**: