/MusicService

A tool that synchronizes your YouTube playlists and other music providers with your Cloud Storage like Nextcloud as MP3s.

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

MusicServiceLogo

Music sync Service (youtube-dl-sync)
Release version Docker Pulls DevOps Build License Issues


A tool that synchronizes your YouTube playlists and other music providers with your Cloud Storage like Nextcloud as MP3s.

What does it do? ✨

  • 🎵 Downloads your music from YouTube, SoundCloud and many more
  • 😁 Automatically monitors your playlists for newly added music
  • 🔄 Converts video files to the highest quality MP3 possible
  •  ☁  Uploads your music as MP3 to your Cloud Storage account. Supports all Cloud providers with WebDAV compatibility: Nextcloud, ownCloud, pCloud, STACK and many more
  • 🖼 Adds coverart to your MP3s automatically
  • 🗃 It's aware of the songs that have already been downloaded. This saves a lot of time since they don't get redownloaded every time the application runs again.

syncShowcase



How to install

The Music Service is a microservice application and runs as a Docker container. Because of using Docker, every installation runs the same, for everyone. This brings programming efficiency and improves reliability. Docker image release

⚠️ You must have Docker installed: Either the Docker Desktop (with GUI) or Engine (no GUI) installed on your system.


  1. How to run the musicservice:
    • Download the Docker Compose file: docker-compose
    • Run docker compose up -d in your terminal to start the stack, wait a few seconds (use without -d if you want to see the logs)
    • Then go to http://localhost:5678/ (localhost or IP of your machine)

Join the team 👪

Feel free to contribute, you can submit issues here and fix issues/bugs, improve the application!


ℹ️ Recommendation: For the best experience, install this container on a computer/server which runs 24/7, so you will always have your music in sync.

Tip

Please consider supporting your favorite artists through buying their music on https://bandcamp.com/ or https://www.beatport.com/

Tip

Use at your own risk, never trust the code of a random dude on the internet without first checking it yourself :)