tunebase

Search and play music right from your terminal

Demo

https://user-images.githubusercontent.com/36772158/227199684-c82053fd-2471-4b1f-8a7a-173a60352ad7.mp4

View this demo video on  YouTube.

Features

• 🔍 Search for music
• 🔉 Increase/decrease volume
• ⏯️ Pause/play music
• 🌁 ASCII characters based thumbnail
• ⏩ Seek forwards and backwards
• 🔢 Supports seeking to specific point (0..9) (6 advances to 60% of duration)
• ✅ Works without login/authentication

Installation

Install or update tunebase with npm:

npm install -g tunebase@latest

View on npm.

Issues

On Mac OS, the package might face an issue while installing VLC. You might need to do it manually.

If you have GUI version of VLC already, remove it using this command:

rm -rf /Applications/VLC.app

After making sure it isn't installed, you need to install VLC using Homebrew:

brew install vlc

This will also install the GUI of VLC.

If you don't have Homebrew, you can install it using:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Usage

Once installed, you can run any of the following commands on your terminal:

play
play [search query]

You can also use the following aliases:

• tunebase
• play-music

Terminal Commands

[search query]        Search and play a song right from your terminal
help                  To show this help menu

Player Commands

SPACE                 Play/Pause
← (left arrow key)    Seek back by 5 seconds
→ (right arrow key)   Seek forward by 5 seconds
↑ (up arrow key)      Increase Volume
↓ (down arrow key)    Decrease Volume
0..9                  Seek to specific point in the song (6 seeks to 60% of duration)

Flags

-h, --help            To show this help menu