🎶
Harmony Music
An easy way to stream videos or music from Youtube from the command line while regaining your privacy.
📖
Table Of Contents
❔ What's this?🎧 Features📜 Requirements🛑 Force mpv to use yt-dlp over youtube-dl💻 Installation👨🔧 Usage
❔
What's this?
Harmony is a command line tool to stream music and videos without worrying about prying eyes from the likes of Youtube. Instead of directly scraping Youtube, Harmony uses Piped instead. This results in not only quicker fetching of results but also prevents Youtube from seeing your IP by proxying videos, all from the comfort of the terminal.
🎧
Features
- Minimal Resource Usage. (Around 1-2% CPU usage while streaming music and 5-10% while playing videos)
- No requests made to Youtube to fetch results.
- Avoid Youtube's georestrictions by using Piped's inbuilt proxy. Works with both the --song and --video flag.
- Ability to filter search queries by music, videos, albums or playlists.
- A proper queue system.
📜
Requirements
-
mpv- An open source command line video player. -
yt-dlp- A youtube-dl fork with additional features and fixes. This is preferred over youtube-dl for a better experience.
🛑
Force mpv to use yt-dlp over youtube-dl
yt-dlp is suggested over youtube-dl as it tends to load videos, music etc. quicker and more importantly works with the --playlist flag.
The recommended way to solve this issue is to just uninstall youtube-dl and install yt-dlp instead.
However, if you would like to have both youtube-dl and yt-dlp installed on your system, add this line to ~/.config/MPV/mpv.conf
script-opts-append=ytdl_hook-ytdl_path=yt-dlp
💻
Installation
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
-h, --help show this help message and exit
--song, -s, --s Searches for songs based on query. Example: harmony
--song "Never gonna give you up"
--video, -v, --v Searches for videos based on the query. Example:
harmony --video "Never gonna give you up"
--album, -a, --a Searches for albums based on the query. Example:
harmony --album "All Over The Place"
--playlist, -p, --p Searches for playlists based on the query. Example:
harmony --playlist "All Over The Place"
16 Nov 30, 2022
1 Jan 17, 2022
2 Feb 4, 2022
14 Oct 21, 2022
15 Dec 24, 2022
1 Nov 10, 2021
8 Aug 4, 2022
4 Dec 1, 2021
2 Dec 27, 2021
1 Nov 30, 2021
2 Oct 25, 2021
5 Jan 27, 2022
59 Dec 04, 2022
18 Jul 31, 2022
74 Dec 22, 2022
509 Jan 02, 2023
96 Dec 16, 2022
977 Jan 05, 2023
153 Dec 28, 2022
2 Jan 02, 2022
12 Oct 02, 2022
2.1k Jan 03, 2023
1 Dec 05, 2021
9 Dec 12, 2022
1 Jul 29, 2022
2 Jan 06, 2022
29 Dec 21, 2022
0 Jan 20, 2022
15 Oct 18, 2021