About | Features | Technologies | Requirements | Starting | License | Disclaimer | Author
MetaTube downloads video from YouTube and can add metadata from a specified metadata provider on the downloaded file.
| Normal view | Dark mode |
|---|---|
 |
 |
It's almost finished and these features are currently supported:
✔️ Fetch information from a YouTube video based on an URL
✔️ Query and fetch results from the Musicbrainz API, the Spotify Web API, and the Deezer API
✔️ Set up templates and options for the YouTube download
✔️ Download YouTube videos based on a selected template
✔️ Exclude fragments (such as intros, outros, etc.) from the download
✔️ Metadata from either the user or the chosen metadata provider can be merged with MP3, Opus, FLAC, WAV, OGG, M4A & MP4 files
✔️ Hardware encoding using NVENC, Intel Quick Sync
✔️ Hardware encoding is supported, but not yet tested for Video Toolbox, Video Acceleration API (VAAPI), AMD AMF & OpenMax OMX
✔️ Manually set height and width, if a video type has been selected
✔️ Store the information about downloaded releases in the database, to edit the downloaded metadata or the file itself later after the download
✔️ Dark mode is available
✔️ Docker is supported
The following tools were used in this project:
- Python
- Flask
- JavaScript
- Bootstrap 4.6
- Dark Mode Switch
- jQuery 3.6.0
- Friconix
- Youtube-DLP
- youtube-search-python
- Spotipy
- Deezer-python
- Python Musicbrainz
- Sponsorblock.py
- FFmpeg 4.4.1
For a complete list, visit the Dependencies overview in the Insights.
Before starting 🏁, you need to have Git and Python 3.8 or higher installed.
CLI docker:
docker run \
-d \
--name metatube \
--restart always \
-p 5000:5000 \
-e PORT=5000 \
-e HOST=0.0.0.0 \
-e DATABASE_URL=sqlite:////database/app.db \
-v /downloads:/downloads:rw \
-v /metatube:/database:rw \
jvt038/metatube:latest
Docker-compose:
version: '3.3'
services:
metatube:
container_name: metatube
restart: always
image: jvt038/metatube:latest
ports:
- '5000:5000'
environment:
- PORT=5000
- HOST=0.0.0.0
- 'DATABASE_URL=sqlite:////database/app.db'
volumes:
- '/downloads:/downloads:rw'
- '/metatube:/database:rw'
You need to set the variable DATABASE_URL to a custom mount point (in these examples /database), because otherwise your database file will reset everytime the Docker container updates.
# Clone this project
$ git clone https://github.com/JVT038/metatube
# Access
$ cd metatube
# Skip these steps if you don't want to use a virtual environment
# Install virtualenv
$ pip install virtualenv
# Create virtual environment in current directory
$ virtualenv .
# Activate environment
# Windows:
$ cd Scripts
$ activate
# Linux:
$ source bin/activate
# Navigate to the root directory
$ cd ../
# Install dependencies
$ pip install -r requirements.txt
# Run the file
$ python metatube.py
# The server will initialize in the <http://localhost:5000>You can set the following environment variables:
| Name | Description | Default value |
|---|---|---|
| PORT | Set the port on which the MetaTube server will be available | 5000 |
| HOST | Set the address on which the MetaTube server will run | 127.0.0.1 |
| DEBUG | Whether to enable debug mode or not | False |
| DATABASE_URL | The URL to your Database. Currently only SQLite3 is supported. | sqlite:///app.db |
| FFMPEG | An absolute path to the folder containing ffmpeg. | Empty |
| DOWNLOADS | An absolute path to the default download folder | /absolute/path/to/MetaTube/downloads; absolute path will be calculated automatically |
| LOG | Whether to keep logs or not | False |
| SOCKET_LOG | Whether to log in- and outcoming websocket connections; warning: your console can be spammed with connections | False |
| LOG_LEVEL | Numeric value from which MetaTube will keep logs. Info here | 10 |
| BUFFER_SIZE | The maximum size of the websockets in bytes; adjust if your covers are too large to be sent | 10000000 (10 million); equal to 10MB |
# On Windows 10, you can set an environment variable like this:
$ set ENVIRONMENT_VARIABLE = Value
# On Linux and MacOS, you can set an environment variable like this:
$ export ENVIRONMENT_VARIABLE = ValueAdditionally you can create a file called .flaskenv and set the environment variables in there.
An example is provided in example.flaskenv. You can use that template and rename the file to .flaskenv.
This project is under license from GNUv3. For more details, see the LICENSE file.
I am not responsible for any legal consequences the user may or may not face by using this project.
Made with ❤️ by JVT038
- Add support for the use of proxies to download YouTube videos
- Add Docker support
- Add Docker support for ARM devices (such as Raspberry Pi)
- Add Github action / workflow thing, to automatically create Docker image upon a new commit
- Add it to the PyPi library
- Add support for sites other than YouTube
- Add support for YouTube playlists
- Add custom YouTube-DLP options
- Add support for H.265 / HEVC
- Add authentication system with an optional reverse proxy
- Add support for TheAudioDB
- Add support for YouTube Music
- Add support for Last.fm!
- Add support for Spotify
- Add support for Deezer
- Add translations
- Add a nice progress bar
- Add a function to allow users to download the song onto their device
- Add in-built file explorer, making manual paths optional
- Add some nice animations
- Add a cancel download button when the video is being downloaded
- Add button in settings to download the entire SQlite3 Database
- Add button in settings to download all the downloaded content
- Add ability to manually set video width & height, if a video type has been selected
- Add ability to manually set video width & height, if a video type has been selected, AFTER the item has been inserted into the database
- Add support for HTTPS / SSL
- Preview filenames when entering an output template
- Make the Docker file smaller, because it's huge
- Build a logger
- Give the user the option which level of logs to show / log and whether to save the logs to a file
- Catch and show errors properly
- Support looking for YouTube videos and downloading them
- Support querying the Musicbrainz database and matching YouTube videos with them
- Support MySQL
- Make a CLI to download and match music
- Store the information of downloaded songs in a SQL database
- Make it mobile-friendly
- Use Sponsorblock and yt-dlp to automatically skip fragments
- Manually edit metadata of file, before the download
- Manually edit metadata of file, after the download
- Select output type (coding, extension, etc.)
- Switch from AJAX to websockets
- Hardware transcoding with NVENC, Intel Quick Sync, Video Acceleration API (VAAPI) & AMD AMF
- Improve the automatic creation of the database, the tables and the default rows, because it's horrible right now.
- Use multiprocessing and websockets to make the overview page faster
- Dark mode support
- Fix error
Synchronous XMLHttpRequest on the main thread is deprecated because of its detrimental effects to the end user’s experience. For more help http://xhr.spec.whatwg.org/in overview - Make sure the search for downloaded song field works
- Have a proper versioning system, because it's impossible to keep track of versions rn
- Cache and store the segments and other video data, so next time of loading a video will be faster
- Send websocket requests to one specific device / client only, to prevent duplicate websocket requests
- Make sure the progress bar works properly in a Docker container, because it doesn't work properly rn.
I made this project to educate myself about Python, and to learn how metadata works in combination with files. Additionally, I want to emphasize I do NOT encourage any pirating, or any other illegal activities. This project's purpose isn't to illegally download content from YouTube; its purpose is to educate and enlighten myself (and others viewing the source code) about Python, how Python interacts with metadata in files, and metadata works, and how yt-dlp works. I am not responsible if the user downloads illegal content, or faces any (legal) consequences.