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

Recommendation systems are among most widely preffered marketing strategies.

Recommendation systems are among most widely preffered marketing strategies. Their popularity comes from close prediction scores obtained from relationships of users and items. In this project, two r

8 Oct 06, 2021

Telegram chats reader with python

Telegram chat reader Программа полностью сливает чаты телеграм в базу данных PostgreSQL. Для использования нужен развернутый сервер постгрес и телегра

4 Dec 24, 2021

Cutting-edge GitHub page customization tool

Cutting-edge GitHub page customization tool Want to customize your GitHub user page, but don't know how? Now you can make your profile unique and attr

32 Aug 24, 2022

Manage Proxmox KVM Virtual Machines via Slack bot.

proxmox-slack-bot Create KVM Virtual Machines on Proxmox, the easy way. Not much works works here yet... Setup dev environment Setup fully editable st

3 Mar 20, 2022

A script to find the people whom you follow, but they don't follow you back

insta-non-followers A script to find the people whom you follow, but they don't follow you back Dependencies: python3 libraries - instaloader, getpass

5 Jul 03, 2022

A python SDK for interacting with quantum devices on Amazon Braket

Amazon Braket Python SDK The Amazon Braket Python SDK is an open source library that provides a framework that you can use to interact with quantum co

213 Dec 14, 2022

Me and @nathanmargni did a small analysis on what are the best strategies to win more games of League of Legends.

2 Jan 19, 2022

:snake: A simple library to fetch data from the iTunes Store API made for Python >= 3.5

itunespy itunespy is a simple library to fetch data from the iTunes Store API made for Python 3.5 and beyond. Important: Since version 1.6 itunespy no

56 Dec 22, 2022

🐍 VerificaC19 SDK implementation for Python

VerificaC19 Python SDK 🐍 VerificaC19 SDK implementation for Python. Requirements Python version = 3.7 Make sure zbar is installed in your system For

10 Jan 14, 2022

Практическая работа 6 - Документирование кода

Практическая работа №6 ПСП – правильная скобочная последовательность – последовательность из открывающих «(« и закрывающих «)» круглых скобок. Програм

0 Apr 14, 2022

Automatically changes your discord status

Automatically changes your discord status, Be careful as this may get you rate limited and banned

5 Sep 20, 2022

GitHub Activity Generator - A script that helps you instantly generate a beautiful GitHub Contributions Graph for the last year.

GitHub Activity Generator A script that helps you instantly generate a beautiful GitHub Contributions Graph for the last year. Before 😐 😶 😒 After ?

1 Dec 30, 2021

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

Recommendation systems are among most widely preffered marketing strategies.

Telegram chats reader with python

Cutting-edge GitHub page customization tool

Manage Proxmox KVM Virtual Machines via Slack bot.

A script to find the people whom you follow, but they don't follow you back

A python SDK for interacting with quantum devices on Amazon Braket

Me and @nathanmargni did a small analysis on what are the best strategies to win more games of League of Legends.

:snake: A simple library to fetch data from the iTunes Store API made for Python >= 3.5

🐍 VerificaC19 SDK implementation for Python

Практическая работа 6 - Документирование кода

Automatically changes your discord status

GitHub Activity Generator - A script that helps you instantly generate a beautiful GitHub Contributions Graph for the last year.

Make a command interpreter that manages AirBnb objects

:electric_plug: Generating short urls with python has never been easier

A simple API Wrapper for Guilded.

PerrOS - The operating system for your discord server.