🎶 Harmony Music

An easy way to stream music or videos from online sources like Youtube from the command line while regaining your privacy.

📖 Table Of Contents

• ❔ What's this?
• 🎧 Features
• 📜 Requirements
• 💻 Installation
• 👨‍🔧 Usage
• 🏥 Contributing

❔ What's this?

Harmony is a command line tool to stream music from the command line without worrying about tracking/profiling. Harmony streams music from Jiosaavn, using a Jiosaavn API to both fetch results and stream music. Instead of streaming videos directly from Youtube, Piped is used instead to both fetch videos and stream videos. It's meant to act as a privacy respecting Spotify TUI.

🎧 Features

• Minimal Resource Usage. 1-5% CPU usage while streaming music, 5-15% CPU usage while streaming videos.
• No tracking whatsoever while streaming music or videos.
• Streams 320 kbps audio and streams the highest quality video available.
• Support for real-time synced lyrics.
• A proper queue system.

📜 Requirements

1. mpv - An open source command line video player.

💻 Installation

Harmony is available in the AUR. You can find it here.

yay -S harmony

Simply download the release binary from the releases section or enter the following commands below in any Linux terminal. (No windows binaries yet!)

sudo wget https://github.com/ZingyTomato/harmonymusic/releases/latest/download/harmony -O /usr/local/bin/harmony
sudo chmod a+rx /usr/local/bin/harmony

👨‍🔧 Usage

usage: harmony [-h] [-v] [SEARCH_QUERY ...]

An open souce CLI music/video streamer based on MPV.

positional arguments:
  SEARCH_QUERY  Name of the song/video to search for. Example: harmony 2step Ed Sheeran

options:
  -h, --help    show this help message and exit
  -v, --video   Allows to search for videos instead of music. Example harmony -v 2step Ed Sheeran

🏥 Contributing

Feel free to create an issue if you encounter any bugs or would like to suggest something!