πΆ
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
3 Mar 11, 2022
17 Nov 25, 2022
1 Nov 13, 2021
22 Dec 22, 2022
14 Oct 15, 2022
10 Apr 28, 2022
5 Jul 21, 2022
837 Jan 07, 2023
2 Feb 05, 2022
2 Dec 29, 2021
1 Oct 30, 2021
18 Dec 17, 2022
41 Nov 02, 2022
2 Apr 01, 2022
15 Oct 23, 2022
9 Dec 02, 2022
4 Mar 18, 2022
3 Dec 03, 2022
154 Dec 01, 2022