🎵 ClimMusic CLI

A beautiful cross-platform CLI YouTube music player with interactive controls.

✨ Features

• 🔍 Search YouTube - Search and play any song
• 📋 Queue Management - Add, remove, shuffle tracks
• 💾 Playlists - Save and load custom playlists
• 🎮 Interactive Controls - Beautiful CMD interface
• ⌨️ Keyboard Support - Full keyboard control
• 🎛️ Volume Control - Adjust playback volume
• 📜 Playback History - Track recently played songs

🎮 Controls

────────────────────────────────────────────
            🎮 Controls
────────────────────────────────────────────

  ▶ Play / Resume   - Start or resume playback
  ⏸ Pause          - Pause current track
  ⏭ Next Track     - Skip to next track
  ⏮ Previous Track - Go to previous track
  🔊 Volume         - Adjust volume (0-100)
  ➕ Add to Queue   - Add new track
  📋 Show Queue     - View all queued tracks
  🔀 Shuffle Queue  - Randomize queue order
  🗑 Clear Queue    - Remove all tracks
  ❌ Quit           - Exit player

⚠️ Prerequisites

You must install these BEFORE using ClimMusic:

| Software | Required | Download | |----------|----------|----------| | Node.js | ✅ Yes | https://nodejs.org | | yt-dlp | ✅ Yes | https://github.com/yt-dlp/yt-dlp | | FFmpeg | ✅ Yes | https://ffmpeg.org/download.html |

Install on Windows (PowerShell - Admin):

choco install nodejs yt-dlp ffmpeg

Install on macOS:

brew install node yt-dlp ffmpeg

Install on Linux (Ubuntu/Debian):

sudo apt update
sudo apt install nodejs npm yt-dlp ffmpeg

🚀 Installation

npm install -g climmusic

📖 Usage

# Start interactive player
climmusic

# Search and play
climmusic play "Never Gonna Give You Up"

# Search only
climmusic search "Beatles"

# Show queue
climmusic queue

📁 Project Structure

climmusic/
├── src/
│   ├── cli.js           # Main CLI entry
│   ├── player/
│   │   └── Player.js    # Audio playback engine
│   └── utils/
│       ├── youtube.js    # YouTube API
│       ├── queue.js      # Queue management
│       ├── playlist.js   # Playlist management
│       ├── config.js     # Settings
│       ├── ui.js         # Beautiful UI
│       └── keyboard.js   # Keyboard controls
├── data/                # Queue & playlist storage
├── package.json
└── README.md

🔧 Troubleshooting

"yt-dlp not found"

choco install yt-dlp
# OR
pip install yt-dlp

"ffmpeg not found"

choco install ffmpeg

Still not working?

• Make sure all prerequisites are in your PATH
• Restart your terminal after installing prerequisites

📝 License

MIT License

Made with ❤️ for music lovers