Skip to content

ZingyTomato/Harmony-Music

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎶 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?

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!