How alexk-cloud/multilyrical works
Multilyrical is a web app for identifying songs, finding lyrics and song details, exploring lyric insights, and translating lyrics. A user can identify a song from a short recording or search by text, then view a results page with lyrics, artwork, album information, and AI-generated insights; translation is available from that page. The browser also supports saved songs and playlists, while recently viewed songs are kept in the Flask session. Source excerpts show the main route-to-service calls; connections for browser storage and external services are grounded in the JavaScript and service implementations.
Main entry points: song.py Song services · app.py Flask routes · script.js Browser interactions · lyric.py Lyrics translation
Components 16
Web experience
- Flask routes
src/Multilyrical/app.py - Page templates
src/Multilyrical/templates - Browser interactions
src/Multilyrical/static/script.js - Page styling
src/Multilyrical/static/style.css
Song discovery
- Song services
src/Multilyrical/song.py - HTTP session
src/Multilyrical/api_client.py - Recent songs
src/Multilyrical/app.py
Lyrics and insights
- Lyrics translation
src/Multilyrical/lyric.py
External services
- Microphone capture
- Shazam recognition
- LRCLIB catalog
- CoverPy artwork
- Gemini analysis
- Google Translate
- Browser storage
Other components
- Listener
Connections 17
- Listener → Browser interactions: uses
src/Multilyrical/static/script.js - Browser interactions → Flask routes: requests routes
src/Multilyrical/static/script.js - Flask routes → Song services: calls song services
src/Multilyrical/app.py - Flask routes → Lyrics translation: calls translation
src/Multilyrical/app.py - Flask routes → Page templates: renders pages
src/Multilyrical/app.py - Browser interactions → Browser storage: reads and writes
src/Multilyrical/static/script.js - Flask routes → Recent songs: updates session
src/Multilyrical/app.py - Song services → Microphone capture: records audio
src/Multilyrical/song.py - Song services → Shazam recognition: recognizes track
src/Multilyrical/song.py - Song services → HTTP session: uses session
src/Multilyrical/song.py - Lyrics translation → HTTP session: uses session
src/Multilyrical/lyric.py - Song services → LRCLIB catalog: searches catalog
src/Multilyrical/song.py - Lyrics translation → LRCLIB catalog: fetches lyrics
src/Multilyrical/lyric.py - Song services → CoverPy artwork: fetches artwork
src/Multilyrical/song.py - Song services → Gemini analysis: generates insights
src/Multilyrical/song.py - Lyrics translation → Google Translate: translates lyrics
src/Multilyrical/lyric.py - Browser interactions → Page styling: displays styled pages