πΆ
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 07, 2021
34 Jan 01, 2023
69 Dec 26, 2022
0 Sep 27, 2022
39 Oct 21, 2022
3 Aug 31, 2022
2 Feb 10, 2022
545 Jan 07, 2023
1 Feb 12, 2022
1 Dec 23, 2021
19 May 21, 2022
2 Jan 08, 2022
1 Nov 18, 2021
80 Oct 05, 2022
10 Dec 26, 2022
13 Dec 15, 2022
2 Dec 22, 2021
0 Dec 23, 2021
3 Aug 07, 2021
85 Nov 18, 2022