Back to browse
GitHub Repository
2 starsPython

Nirvana – A TUI YouTube Music Player with a Physics-Based Visualizer

by ekabir·Mar 7, 2026·4 points·0 comments

AI Analysis

●●SolidEye CandyWizardryNiche Gem

Physics-based visualizer with OS-level pause suspension, but yt-dlp YouTube extraction isn't novel.

Strengths
  • Physics-driven 30+ FPS visualizer with gravity peak-drop and symmetry is technically impressive
  • OS-level process suspension for stutter-free pause without buffering cuts
  • Textual-based TUI feels modern and responsive with proper keyboard navigation
Weaknesses
  • Requires YouTube API key setup and external ffmpeg dependency adds friction to installation
  • YouTube Music functionality directly competes with established clients (Spotify CLI, ncspot) with no differentiation
Target Audience

Terminal users, music lovers, CLI enthusiasts

Similar To

ncspot · spotify-tui · cmus

Post Description

Most CLI players have very rudimentary visualizations, so I focused on creating a "Quantum Spectrum Analyzer"—a high-frame-rate, physics-driven rainbow visualizer that uses gravity-based peak falling and mirrored symmetry.

Under the hood, it manages a pool of ffplay instances and uses OS-level process suspension (via ctypes on Windows and signal on POSIX) to provide an "instant-off" pause experience without cutting the audio buffer mid-stream.

Check it out here: https://github.com/iamekabir-web/Nirvana

Similar Projects