tunity
v1.0.1
Published
Play any song instantly from your terminal using YouTube
Maintainers
Readme
Tunity - Terminal Music Player
Play any song instantly from your terminal using YouTube.
Features
- 🎵 Search and play songs from YouTube directly in your terminal
- 🔍 Interactive search with song selection
- 📜 View your listening history
- 🎮 Simple playback controls
- 🚀 Fast and lightweight
Installation
Prerequisites
- Node.js (v16 or higher)
- Python 3.7+
- ffmpeg (for audio playback)
- yt-dlp (Python package)
Install Python Dependencies
pip install yt-dlpInstall ffmpeg
Ubuntu/Debian:
sudo apt update
sudo apt install ffmpegmacOS:
brew install ffmpegWindows: Download from ffmpeg.org or install via Chocolatey:
choco install ffmpegInstall Tunity
# Clone the repository
git clone https://github.com/yourusername/tunity.git
cd tunity
# Install dependencies
npm install
# Build the project
npm run build
# Link the CLI globally (optional)
npm linkUsage
Play a song
tunity play "song name"Search for songs
tunity search "song name"This will display a list of search results and allow you to select a song to play.
View your listening history
tunity historyHelp
tunity --helpPlayback Controls
- Space - Play/Pause
- q - Quit
- → - Forward
- ← - Rewind
Development
# Run in development mode
npm run dev
# Build for production
npm run buildLicense
ISC
