How luqman234/meowplayer works
MeowPlayer is a local-first terminal music player. Its principal workflow is to scan local files, read and cache metadata, present a keyboard-driven library, and send playback commands to mpv; online search and lyrics are optional extensions. The graph preserves the README’s major discovery, desktop-control, and terminal-display capabilities. Some wiring is documented at product level rather than visible in the sampled excerpts, so those relationships cite the README; unsampled internals are not inferred.
Components 23
Library and discovery
- Library scanning
meowplayer.py - Filesystem watcher
library_watcher.py - Local metadata
meowplayer.py - SQLite catalog
meow_catalog.py - Library discovery
meowplayer.py - Smart mixes
meow_smart.py
Playback and online
- mpv engine
- Online streams
youtube_online.py - YouTube and NicoNico
User interface
- Terminal player
meowplayer.py - Settings
settings_nest.py - Album art
album_art.py - Spectrum display
visualizer.py - Cat presence
cat_presence.py - Bad Larry
bad_larry.py - Chaos questions
bad_larry_math.py
Desktop and enrichment
- Lyrics
lyrics_support.py - LRCLIB
- Metadata enrichment
online_metadata.py - MusicBrainz
- MPRIS controls
mpris_support.py
Other components
- Listener
- D-Bus clients
Connections 24
- Listener → Terminal player: controls
README.md - Terminal player → Library scanning: scans files
README.md - Library scanning → Local metadata: reads tags
README.md - Library scanning → SQLite catalog: caches metadata
README.md - Filesystem watcher → Terminal player: signals changes
README.md - Terminal player → Library discovery: presents library
README.md - Library discovery → SQLite catalog: reads history
README.md - Library discovery → Smart mixes: offers mixes
README.md - Listener → Terminal player: chooses music
README.md - Terminal player → mpv engine: controls playback
README.md - Terminal player → Online streams: requests streams
README.md - Online streams → YouTube and NicoNico: searches streams
README.md - Terminal player → Lyrics: loads lyrics
README.md - Lyrics → LRCLIB: looks up lyrics
README.md - Terminal player → Metadata enrichment: enriches missing tags
README.md - Metadata enrichment → MusicBrainz: queries metadata
README.md - D-Bus clients → MPRIS controls: sends controls
README.md - MPRIS controls → Terminal player: dispatches commands
README.md - Terminal player → Settings: configures player
README.md - Terminal player → Album art: shows cover art
README.md - Terminal player → Spectrum display: shows spectrum
README.md - Terminal player → Cat presence: updates mascot
README.md - Terminal player → Bad Larry: runs incidents
README.md - Bad Larry → Chaos questions: uses questions
bad_larry.py