An open souce video/music streamer based on MPV and piped.

Last update: Nov 15, 2022

Overview

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

You might also like...

Video-Player - Telegram Music/ Video Streaming Bot Using Pytgcalls

Video Player 🔥 ᴢᴀɪᴅ ᴠᴄ ᴘʟᴀyᴇʀ ɪꜱ ᴀ ᴛᴇʟᴇɢʀᴀᴍ ᴘʀᴏᴊᴇᴄᴛ ʙᴀꜱᴇᴅ ᴏɴ ᴘʏʀᴏɢʀᴀᴍ ꜰᴏʀ ᴘʟᴀʏ

16 Nov 30, 2022

Play Video & Music on Telegram Group Video Chat

Video Stream is an Advanced Telegram Bot that's allow you to play Video & Music on Telegram Group Video Chat 🧪 Get SESSION_NAME from below: Pyrogram

1 Jan 17, 2022

Latest Open Source Code for Playing Music in Telegram Video Chat. Made with Pyrogram and Pytgcalls 💖

MusicPlayer_TG Latest Open Source Code for Playing Music in Telegram Video Chat. Made with Pyrogram and Pytgcalls 💖 Requirements 📝 FFmpeg NodeJS nod

2 Feb 4, 2022

A Telegram Music Tag Editor Bot that can remove almost all usernames in the music tags and add own username instead.

Music Tag Editor Bot A Telegram Music Tag Editor Bot that can remove almost all usernames in the music tags and add own username instead. It can also

14 Oct 21, 2022

📢 Video Chat Stream Telegram Bot. Can ⏳ Stream Live Videos, Radios, YouTube Videos & Telegram Video Files On Your Video Chat Of Channels & Groups !

Telegram Video Chat Bot (Beta) 📢 Video Chat Stream Telegram Bot 🤖 Can Stream Live Videos, Radios, YouTube Videos & Telegram Video Files On Your Vide

15 Dec 24, 2022

Video Stream is a telegram bot project that's allow you to play video on telegram group video chat

Video Stream is a telegram bot project that's allow you to play video on telegram group video chat 🚀 Get SESSION_NAME from below: Pyrogram ## ✨ Featu

1 Nov 10, 2021

VC-Music , Playing music without bot.

VC-Userbot A Telegram Userbot to play or streaming Audio and Video songs / files in Telegram Voice Chats. It's made with PyTgCalls and Pyrogram Requir

8 Aug 4, 2022

Music bot for playing music on telegram voice chat group.

Somali X Music 🎵 Music bot for playing music on telegram voice chat group. Requirements FFmpeg NodeJS nodesource.com Python 3.8+ or Higher PyTgCalls

4 Dec 1, 2021

this is an op music pyrogram music bot.

amanrajputpytgcallmusic this is an op music pyrogram music bot..... this bot user music bot can play music without being admin...... TG-MusicPlayer A

2 Dec 27, 2021

Comments

Playling playlists from Youtube

I am not able to play playlists from youtube. I think the problem happens with all playlists as youtube-dl simply do not accept piped playlists url:

> python harmony.py --playlist "red hot chili peppers"

Searching for playlists...

Results for red hot chili peppers

0. Red Hot Chili Peppers - Unlimited Love (FULL ALBUM) - ESSBY
1. Best Of Red Hot Chili Peppers - Dean Cook
2. RHCP - The Red Hot Chili Peppers - ToonsToob
3. Red Hot Chili Peppers Greatest Hits - Joaquin Barbaglia
4. All songs by Red Hot Chili Peppers - allSongsBy
5. Red Hot Chili Peppers Radio - Harry
6. Rock - best of Red Hot Chili Peppers, Nirvana, Metallica, Blur, The White Stripes, The Cranberries - What now
7. Red Hot Chili Peppers PLAYLIST!!! - poompeyloompey
8. Red Hot Chili Peppers Radio - George Kost
9. Red Hot Chili Peppers - Californication (1999 - Full Album) - Le Sémaphore
10. Red Hot Chili Peppers - Playlist - Alin Iliuta
11. Red Hot Chili Peppers - Stadium Arcadium (Complete Album) - Nick
12. Red Hot Chili Peppers - Unlimited Love (Full Album, 2022/Álbum Completo) - Best Songs Playlist 2022
13. Red Hot Chili Peppers - Unlimited Love (ALBUM) - HULLE KAN  NIE MET MY NIE
14. RHCP Playlist - iandim
15. Red Hot Chili Peppers YouTube Mix - Sam Harris
16. The Getaway - Red Hot Chili Peppers (Full Album) - Dylan Hallett
17. Red Hot Chili Peppers on the Stern Show - The Howard Stern Show
18. Nirvana Red Hot Chili Peppers Green Day Offspring Blink-182 - Ricky Arreola
19. Red Hot Chili Peppers - Unlimited Love (Instrumentals) - Djancarlo Shatunov - Instrumentals & Acapellas

Pick an option [0:19, (B)ack]: 0

Red Hot Chili Peppers - Unlimited Love (FULL ALBUM) - ESSBY has been added to the queue.

Add playlists to the Queue (P)lay, (S)how Queue, (B)ack, (Q)uit: P

Playing items in the queue (q to quit)

0. Red Hot Chili Peppers - Unlimited Love (FULL ALBUM) - ESSBY

[ytdl_hook] ERROR: Unsupported URL: https://piped.kavin.rocks/playlist?list=PLfiMjLyNWxeZnoC5NvrDI_-61s0TRSeay
[ytdl_hook] youtube-dl failed: unexpected error occurred
Failed to recognize file format.

Exiting... (Errors when loading file)
Add playlists to the Queue (P)lay, (S)how Queue, (B)ack, (Q)uit:

opened by FrancescoCappio 10

Releases(v0.4.5.3)

v0.4.5.3(Jul 4, 2022)
What's changed?

Added a new --trending flag. https://github.com/ZingyTomato/Harmony-Music/commit/aca89efd7524b9dc51f760e28132047df111f46f

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(11.49 MB)
v0.4.5.2(Jun 11, 2022)
What's changed?

Removed the --video flag once again.

Improved accuracy of synced lyrics. https://github.com/ZingyTomato/Harmony-Music/commit/9f58fc218479d8d5f125bbe6b63b3a0d85248759

Removed ASCII characters in the lyrics to prevent Unicode errors. https://github.com/ZingyTomato/Harmony-Music/commit/660fda6466f4ed4d2225a3b0879ad10b6526d693

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(11.49 MB)
v0.4.5.1(Jun 6, 2022)
What's changed?

Reverted back to the previous synced lyrics solution. https://github.com/ZingyTomato/Harmony-Music/commit/98b1ac9df21a3313758f96567bcfa2eb756fad7c

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(11.49 MB)
v0.4.5(Jun 5, 2022)
What's changed?

New source for synced lyrics. https://github.com/ZingyTomato/Harmony-Music/commit/3df15250301c69018dfe5e2e2ba19165b5943494

The screen now clears before reaching the play screen. https://github.com/ZingyTomato/Harmony-Music/commit/3df15250301c69018dfe5e2e2ba19165b5943494

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(11.49 MB)
v0.4.4(Jun 4, 2022)
What's changed?

New Icon displayed for Explicit Songs. https://github.com/ZingyTomato/Harmony-Music/commit/2472fca075fb4411c5a9d18dbcb8fb05cdc1808f

Updated documentation and warn if no results found. https://github.com/ZingyTomato/Harmony-Music/commit/fc00f42683f2c4c24079ae91e92f738b89954c8f

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(11.49 MB)
v0.4.3(May 30, 2022)
What's changed?

Warn when no stream URL found. https://github.com/ZingyTomato/Harmony-Music/commit/466fea5e8744b5e8306b0673c90c51c6388a3c26

Improved readability of lyrics. https://github.com/ZingyTomato/Harmony-Music/commit/b94b7dbb6a3b76f7fe37ffa5c603237d4c58c473

New GitHub action to build binaries. https://github.com/ZingyTomato/Harmony-Music/commit/812973fb11c44384d64d7f2ae64d1424e18ed531

Fixed formatting of certain characters. https://github.com/ZingyTomato/Harmony-Music/commit/8225267d9409741ca14e6527aabb8150cd32136b

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(11.49 MB)
v0.4.2(May 21, 2022)
What's changed?

Re-added the --video flag, added support for real-time synced lyrics. https://github.com/ZingyTomato/Harmony-Music/commit/b51a939d0826b933b64e7e05455c369772ad9e4a

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(18.13 MB)
v0.4.1(May 17, 2022)
What's changed?

Harmony now streams music from JioSaavn instead of Piped. https://github.com/ZingyTomato/Harmony-Music/commit/e4e4a5575691ccd700f6370e2daeabd38b1b3706

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

AUR users can check for updates using their respective AUR helpers.

Source code(tar.gz)
Source code(zip)
harmony(7.02 MB)
v0.4(May 15, 2022)
What's changed?

The project has been rewritten and it is now completely focused on music. https://github.com/ZingyTomato/Harmony-Music/commit/b71f1c492698894f322da3efe46bd912f1ce63c9

Updated Showcase GIF. https://github.com/ZingyTomato/Harmony-Music/commit/b00ddab5934f651288223c3a912f8279ecfbab52

Binaries now contain all required dependencies. https://github.com/ZingyTomato/Harmony-Music/commit/f7adf346afd20c805fb57eac7db9eabd47289276

Updated documentation. https://github.com/ZingyTomato/Harmony-Music/commit/4ccba359808daf189178e0aee46b00a1f8452fb6

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

Source code(tar.gz)
Source code(zip)
harmony(18.13 MB)
v0.3.1(May 1, 2022)
What's changed?

The --video flag now uses piped's proxy to play videos and the currently playing track's title now shows up below mpv's progress bar. https://github.com/ZingyTomato/Harmony-Music/commit/aa958531e255b5e600f4f99753dce864f321ff1b

Fixed certain track's title not displaying. https://github.com/ZingyTomato/Harmony-Music/commit/efa4d8a2a6eb2a13af2c3b4b2e97ac433e03c2da

Updated documentation. https://github.com/ZingyTomato/Harmony-Music/commit/0a0bf510b227e5efa44ed5436fd1c0120430bbef

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

Source code(tar.gz)
Source code(zip)
harmony(9.11 MB)
v0.3(Apr 29, 2022)
What's changed?

Implemented color scheme in more areas of the program. https://github.com/ZingyTomato/Harmony-Music/commit/500708ba8ccedd922dab18287b37f7231e0bbd79

Added new loading messages between certain actions. https://github.com/ZingyTomato/Harmony-Music/commit/d49a6aabd92d6e898d9ab2e14c39884bf5e3c068

The --song flag now uses piped's proxy to play tracks. https://github.com/ZingyTomato/Harmony-Music/commit/c7895ade8b084b561040d0f6d74b8f96346e2997

Updated documentation. https://github.com/ZingyTomato/Harmony-Music/commit/872c96b0a47f5eee1746b9206a14a0741982a834

How to update?

Remove the old binary using sudo rm /usr/local/bin/harmony

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

Source code(tar.gz)
Source code(zip)
harmony(9.11 MB)
0.2(Apr 23, 2022)
What's changed?

Added a quit option while picking items. https://github.com/ZingyTomato/Harmony-Music/commit/72c0d72f69e8569e62def00fbe335ab4a6f0ae08

Many UX improvements. https://github.com/ZingyTomato/Harmony-Music/commit/886b65e493ba0fb1a7dc7c4c769183ead5263dbf

Fixed inconsistent spacing between various messages. https://github.com/ZingyTomato/Harmony-Music/commit/cd3e2d9d6263b7e8f026fd07b8ee966b008153cc

Added new documentation for how to install yt-dlp over youtube-dl. https://github.com/ZingyTomato/Harmony-Music/commit/fce1e0cc9200772dbba2729486b8eb65805bf9a7

How to update?

Remove the old binary located in /usr/local/bin/harmony.

Re-enter the commands in the install section or download the new binary from the releases section and place it in /usr/local/bin.

Source code(tar.gz)
Source code(zip)
harmony(9.11 MB)
v0.1(Apr 21, 2022)

The first public release of harmony!
Source code(tar.gz)
Source code(zip)
harmony(9.11 MB)

Owner

Zingy Tomato

I uh... try to make stuff.

GitHub Repository

Pure Python implementation of the Windows API method IDvdInfo2::GetDiscID.

pydvdid-m Pure Python implementation of the Windows API method IDvdInfo2::GetDiscID. This is a modification of sjwood's pydvdid. The Windows API metho

4 Nov 22, 2022

Repository containing the project files for CEN4020's Team Utah.

inCollege-Team-Utah Repository containing the project files for CEN4020's Team Utah. Contributors: Deepak Putta Jose Ramirez Fuentes Jaason Raudales C

3 Jul 12, 2022

A program that automates the boring parts of completing the Daily accounting spreadsheet at Taos Ski Valley

TSV_Daily_App A program that automates the boring parts of completing the Daily accounting spreadsheet at my old job. To see how it works you will nee

2 Jan 01, 2022

A Python wrapper around the OpenWeatherMap web API

PyOWM A Python wrapper around OpenWeatherMap web APIs What is it? PyOWM is a client Python wrapper library for OpenWeatherMap (OWM) web APIs. It allow

740 Dec 18, 2022

RChecker - Checker for minecraft servers

🔎 RChecker v1.0 Checker for Minecraft Servers 💻 Supported operating systems: ✅

1 Aug 30, 2022

Pythonic and easy iCalendar library (rfc5545)

ics.py 0.8.0-dev : iCalendar for Humans Original repository (GitHub) - Bugtracker and issues (GitHub) - PyPi package (ics) - Documentation (Read The D

513 Jan 02, 2023

Crosschat - A bot for cross-server communication

CrossChat A bot for cross-server communication. Running the bot To run the bot y

8 May 15, 2022

An opensource chat service that cares about your privacy.

An opensource chat service that cares about your privacy. Instructions to set up a local testing environment: 1) Clone this repository and navigate to

2 Dec 03, 2022

A Telegram Bin Checker Bot made with python for check Bin valid or Invalid. 💳

Bin Checker Bot A Telegram Bin Checker Bot made with python for check Bin valid or Invalid. 📌 Deploy On Heroku 🏷 Environment Variables API_ID - Your

20 Dec 10, 2022

Video Stream is a telegram bot project that's allow you to play video on telegram group video chat

Video Stream is a telegram bot project that's allow you to play video on telegram group video chat 🚀 Get SESSION_NAME from below: Pyrogram ## ✨ Featu

1 Nov 10, 2021

A web app via which users can buy and sell stocks using virtual money

finance Virtual Stock Trader. A web app via which users can buy and sell stocks using virtual money. All stock prices are real and provided by IEX. Fe

0 Jan 15, 2022

Set up recurring buys in Gemini

Overview Set up recurring buys in Gemini. Given some keys (Create API Keys), allows you to configure a recurring buy using the reduced API maker and t

3 Jan 06, 2022

A minimal open source mtg-like tcg game made in python that can be played on a terminal emulator using a keyboard.

TCG-TERM Project state: 🔧 🚧 🚧 🚧 Incomplete, In development 🚧 🚧 🚧 👷 (Keep in mind that at the moment, This project is currently undone, and wil

3 Aug 29, 2021

A simple telegram bot to help you to remove forward tag from post from any messages . Maded in python3 using @Pyrogram . Developed by @Kunal-Diwan

Frwd-Tag-Remover Telegram Bot to Remove forward tag from any Post . If you need any more modes in repo or If you find out any bugs, mention in @Develo

2 Oct 14, 2022

An open souce video/music streamer based on MPV and piped.

Related tags

Overview

🎶 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

You might also like...

Video-Player - Telegram Music/ Video Streaming Bot Using Pytgcalls

Play Video & Music on Telegram Group Video Chat

Latest Open Source Code for Playing Music in Telegram Video Chat. Made with Pyrogram and Pytgcalls 💖

A Telegram Music Tag Editor Bot that can remove almost all usernames in the music tags and add own username instead.

📢 Video Chat Stream Telegram Bot. Can ⏳ Stream Live Videos, Radios, YouTube Videos & Telegram Video Files On Your Video Chat Of Channels & Groups !

Video Stream is a telegram bot project that's allow you to play video on telegram group video chat

VC-Music , Playing music without bot.

Music bot for playing music on telegram voice chat group.

this is an op music pyrogram music bot.

Comments

Playling playlists from Youtube

Releases(v0.4.5.3)

v0.4.5.3(Jul 4, 2022)

What's changed?

How to update?

v0.4.5.2(Jun 11, 2022)

What's changed?

How to update?

v0.4.5.1(Jun 6, 2022)

What's changed?

How to update?

v0.4.5(Jun 5, 2022)

What's changed?

How to update?

v0.4.4(Jun 4, 2022)

What's changed?

How to update?

v0.4.3(May 30, 2022)

What's changed?

How to update?

v0.4.2(May 21, 2022)

What's changed?

How to update?

v0.4.1(May 17, 2022)

What's changed?

How to update?

v0.4(May 15, 2022)

What's changed?

How to update?

v0.3.1(May 1, 2022)

What's changed?

How to update?

v0.3(Apr 29, 2022)

What's changed?

How to update?

0.2(Apr 23, 2022)

What's changed?

How to update?

v0.1(Apr 21, 2022)

Owner

Zingy Tomato

Pure Python implementation of the Windows API method IDvdInfo2::GetDiscID.

Repository containing the project files for CEN4020's Team Utah.

A program that automates the boring parts of completing the Daily accounting spreadsheet at Taos Ski Valley

A Python wrapper around the OpenWeatherMap web API

RChecker - Checker for minecraft servers

Pythonic and easy iCalendar library (rfc5545)

Crosschat - A bot for cross-server communication

An opensource chat service that cares about your privacy.

A Telegram Bin Checker Bot made with python for check Bin valid or Invalid. 💳

Video Stream is a telegram bot project that's allow you to play video on telegram group video chat

A web app via which users can buy and sell stocks using virtual money

Set up recurring buys in Gemini

A minimal open source mtg-like tcg game made in python that can be played on a terminal emulator using a keyboard.

A simple telegram bot to help you to remove forward tag from post from any messages . Maded in python3 using @Pyrogram . Developed by @Kunal-Diwan

A Telegram Music Tag Editor Bot that can remove almost all usernames in the music tags and add own username instead.

A multi purpose discord bot for python