πΆ
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
18 Feb 8, 2022
6 Feb 8, 2022
5 Jan 26, 2022
4 Nov 5, 2022
143 Jun 19, 2022
2 Dec 8, 2022
1 Dec 28, 2021
73 Jan 1, 2023
11 Dec 25, 2022