ZingyTomato / Harmony-Music

An open souce music streamer based on MPV and piped.

🎶 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.[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.
• Streams 320 kbps audio.
• 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!