coolThing 🎸✨

Retro web experiments, local music tools, and small repo utilities.

Live site: https://mcamner.github.io/coolThing/

---

What's inside

• docs/ - static GitHub Pages site and browser experiments
• backend/ - local FastAPI backend for music features
• tools/ - shell scripts for local development and repo workflow

Projects

👁 PromptImage

AI Vision for Perchance.org. Upload an image to generate high-quality positive and negative prompts using GPT-4o-mini vision.

• Files: docs/prompt-image/index.html, backend/app.py
• Local: http://localhost:3000/prompt-image/

🎸 Mega Guitar Tabs

MTV-style guitar tab generator prototype. The browser UI sends a YouTube URL to the local backend, which downloads audio, runs Basic Pitch transcription, detects chords, transcribes lyrics (via Whisper), and returns a generated guitar tab.

• Files: docs/mega-guitar/, backend/app.py
• Live Demo: Mega Guitar

🎵 Mega Now

Spotify "now playing" display with album art, audio features, and handoff to Mega Guitar.

• Files: docs/mega-now/index.html, backend/app.py
• Local: http://localhost:3000/mega-now/

---

Quick start

🚀 Installation & Launch

Start the backend and local frontend together:

# Install dependencies and start servers
./tools/start.sh

Then open http://localhost:3000/.

🛠 Individual components

• Backend: ./tools/run-mega-guitar-backend.sh
• Frontend: ./tools/serve-frontend.sh

---

Examples

🖼 Generate Image Prompts

Use the PromptImage API directly:

curl -X POST http://127.0.0.1:8001/prompt-image -F "file=@image.jpg"

🎤 Local Lyrics Transcription

Example of using the API to transcribe lyrics:

curl -X POST http://127.0.0.1:8001/lyrics -F "file=@myaudio.mp3"

---

Screenshots & Demo

Check out the Screenshots Gallery for a visual overview of the different tools.

---

Roadmap

Check the Roadmap for future plans:

• Mobile App: React Native wrapper for Mega Tuner and Setlist.
• AI Harmony: Add backing track generation using Riffusion.
• PromptHistory: Save previous image prompts in local storage.

---

Contributing

We love contributions! Please see our Contributing Guidelines to get started.

1. Fork the repo
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

Security & Safety

This project runs locally. Ensure your OPENAI_API_KEY and Spotify credentials are kept in a non-committed .env file. The backend does not expose ports to the public internet by default.

---

License

MIT © 2026 Mattias Camner