update readme.md
Hunter
Monday, November 10th, 2025 at 3:09 PM
1 # 💿 vibe capsule
2
-resurrect the lost art of <a href="https://ihavethatonvinyl.com/liner-notes/the-lost-art-of-the-mixtape/">mixtape</a><a href="https://melos.audio/blogs/information/the-lost-art-of-the-mixtape">-making</a> by packaging folders of .MP3s as progressive web apps.
3 +resurrect the lost art of <a href="https://ihavethatonvinyl.com/liner-notes/the-lost-art-of-the-mixtape/">mixtape</a><a href="https://melos.audio/blogs/information/the-lost-art-of-the-mixtape">-making</a> by packaging folders of .mp3s as progressive web apps.
4
5 <img src="readme_images/collection.jpeg" width="550">
6
29 it's yours, and then it's theirs.
30
31 ## quickstart
-1. **add your .MP3 files** to the `/tracks` directory
32 +1. **add your .mp3 files** to the `/tracks` directory
33 - you can do this manually or run `rip.py` to rip tracks from a physical CD
34 2. **give it a listen**
35 - run `scan.py` to parse the contents of `/tracks` and populate `tracks.json`, which defines the songs available to the player. after running `scan.py` once, you can manually edit `tracks.json` to refine your mix.
36 - run `host.py` to start a local HTTP server for testing. scan the QR code printed to the terminal to test the app from any device on your local network.
37
38 3. **build the PWA**
- - run `generate_manifests.py` and follow the interactive prompts to specify an app name and remote server path. this generates:
39 + - run `generate_manifests.py` and follow the interactive prompts to specify an app name and the remote server path where your app will be hosted. this generates:
40 - `manifest.json` (PWA configuration file)
41 - `resource-manifest.json` (defines the files to be cached for offline use)
42 - `service-worker.js` (manages offline caching)
45 - upload the entire project directory to any web host with HTTPS support (GitHub Pages, AWS S3, etc.)
46 5. **install on your device**
47 - visit the hosted URL and follow your browser's prompts to "install" or "add app to home screen" (detailed instructions <a href="https://hunterirving.github.io/web_workshop/pwa">here</a>)
- - once installed, your mixapp works completely offline and runs like a native application:<br><br>
48 + - once installed, the app works completely offline and behaves like a native application<br><br>
49 <img src="readme_images/lock_screen.jpeg" width="275"><br>
50 (pictured: integration with iOS lockscreen controls)
51