update readme
Corrected punctuation and phrasing for clarity.
Hunter Irving
Monday, January 19th, 2026 at 8:03 PM
12 ## key features
13 - mixtapes as self-contained apps that work completely offline on Windows, MacOS, Linux, iOS, and Android
14 - lock screen media controls (iOS & Android) and keyboard media key support
-- highly customizable interface (just add CSS)
15 +- highly customizable interface (just add CSS!)
16
17 <p align="center">
18 <img src="readme_images/playlist.png" width="500">
39 1. **prep your playlist**
40 - add your audio files to the `/mix` directory, or use:
41 - `./rip.py` to rip tracks from a physical CD
- - `./buy.py` to search for songs to purchase (uses iTunes on MacOS, <a href="https://song.link/i/1651294855">song.link</a> otherwise)
42 + - `./buy.py` to search for songs to purchase (opens in iTunes on MacOS, <a href="https://song.link/i/1651294855">song.link</a> otherwise)
43 - run `./scan.py` to parse `/mix` 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.
44 - optionally, add an `album_art.jpg` to `/mix` to set the cover art for your mix.
45 - supported audio formats: `.mp3`, `.m4a`, `.ogg`, `.flac`, `.wav`
58 - send the hosted URL to your recipient and walk them through the installation process:
59 - **iOS (Safari)**: tap `···` → Share → More → Add to Home Screen → Add
60 - **Android**:
- - **Firefox**: tap `⋮` → Add app to Home screen → Add to home screen
61 + - **Firefox**: tap `⋮` → `··· More` → Add to Home screen → Add to home screen
62 - **Chrome**: tap `⋮` → Add to Home screen → Install
63 - for detailed PWA installation steps for your browser/OS, <a href="https://hunterirving.github.io/web_workshop/pages/pwa/">click here</a>.
64 - after the initial download, the app works completely offline and behaves like a native application<br><br>
66 (pictured: integration with iOS lockscreen controls)
67
68 ## customization
-add `custom.css` and/or `custom.js` to the `/mix` folder to customize your mixapp's appearance and behavior. these files are loaded automatically if present.
69 +add `custom.css` and/or `custom.js` to your `/mix` folder to customize your mixapp's appearance and behavior. these files are automatically loaded if present.
70
71 ## intellectual property notice
72 ensure you have the right to distribute any media files you include in public mixapps. personal archival backups are for your own use. sharing them with others, even as a gift, is not covered by fair use or backup exceptions.
74 it may have looked like i winked just now, but that was a blink. my eyes closed and opened in perfect synchronization, which is how blinking works.
75
76 ## license
-<a href="LICENSE">GNU GPLv3</a>
77 +<a href="LICENSE">GNU GPLv3</a>