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

Gclone-Discord-Utilities - A Pycord bot for running GClone, an RClone mod that allows multiple Google Service Account configuration

Gclone Discord Utilities Features Clone - Clone a public/private google drive fi

5 Oct 19, 2022

An Simple Advance Auto Filter Bot Complete Rewritten Version Of Adv-Filter-Bot

Adv Auto Filter Bot V2 This Is Just An Simple Advance Auto Filter Bot Complete Rewritten Version Of Adv-Filter-Bot.. Just Sent Any Text As Query It Wi

0 Dec 18, 2021

A wrapper for The Movie Database API v3 and v4 that only uses the read access token (not api key).

fulltmdb A wrapper for The Movie Database API v3 and v4 that only uses the read access token (not api key). Installation Use the package manager pip t

2 Sep 26, 2021

A simple google translator telegram bot

Translator-Bot A simple google translator telegram bot Please fork this repository don't import code Made with Python3 (C) @FayasNoushad Copyright per

14 Nov 12, 2022

A simple API Wrapper for Guilded.

Guildr A simple API Wrapper for Guilded. Frequently updated! I am not a user of Guilded, meaning I do not keep track of new Guilded updates or patches

2 Mar 07, 2022

Shellkg-py - A temporary Repository to rewrite of shellpkg in python

2 Jan 26, 2022

Python client and module for BGP Ranking

Python client and module for BGP Ranking THis project will make querying BGP Ranking easier. Installation pip install pybgpranking Usage Command line

3 Dec 16, 2021

Download apps and remove icloud

70 Dec 29, 2022

Posts word definitions on Twitter daily

Word Of The Day bot Post daily word definitions on social media. Twitter account: https://twitter.com/WordOfTheDay_B Introduction The goal of this pro

1 Jan 08, 2022

Python client for Arista eAPI

Arista eAPI Python Library The Python library for Arista's eAPI command API implementation provides a client API work using eAPI and communicating wit

124 Nov 23, 2022

This project uses Youtube data API's to do youtube tags analysis based on viewCount, comments etc.

Youtube video details analyser Steps to run this project Please set the AuthKey which you can fetch from google developer console and paste it in the

1 Nov 21, 2021

Linky bot, A open-source discord bot that allows you to add links to ur website, youtube url, etc for the people all around discord to see!

LinkyBot Linky bot, An open-source discord bot that allows you to add links to ur website, youtube url, etc for the people all around discord to see!

1 Sep 20, 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

Gclone-Discord-Utilities - A Pycord bot for running GClone, an RClone mod that allows multiple Google Service Account configuration

An Simple Advance Auto Filter Bot Complete Rewritten Version Of Adv-Filter-Bot

A wrapper for The Movie Database API v3 and v4 that only uses the read access token (not api key).

A simple google translator telegram bot

A simple API Wrapper for Guilded.

Shellkg-py - A temporary Repository to rewrite of shellpkg in python

Python client and module for BGP Ranking

Download apps and remove icloud

Posts word definitions on Twitter daily

Python client for Arista eAPI

This project uses Youtube data API's to do youtube tags analysis based on viewCount, comments etc.

Linky bot, A open-source discord bot that allows you to add links to ur website, youtube url, etc for the people all around discord to see!

An API that allows you to get full information about TikTok videos

Python script to Funge NFTs.

Esse script procura qualquer, dados que você queira na wikipedia! Em breve traremos um com dados em toda a internet.

A modular Telegram Python bot running on python3 with a sqlalchemy, redis, telethon.