AMVD - Automated Music Video Downloader

RandomNinjaAtk/amvd is a Lidarr companion script to automatically download and tag Music Videos for use in other video applications (plex/kodi/jellyfin/emby)

Video Example (Kodi)

Audio (AMD) + Video (AMVD) (Plex Example)

Features

• Downloading Music Videos using online sources for use in popular applications (Plex/Kodi/Emby/Jellyfin):
  • Support for IMVDb (https://imvdb.com) to find videos
  • Support for Musicbrainz Database (https://musicbrainz.org) to find videos
  • Downloads using Highest available quality for both audio and video
  • Saves thumbnail of video locally for Plex/Kodi/Jellyfin/Emby usage
  • Matching videos with Musicbrainz Artist track info
  • Embed subtitles if available matching desired language
  • Writes metadata into Kodi/Jellyfin/Emby compliant NFO file
    • Tagged Data includes
      • Matched Title (MusicBrainz), fallback to IMVDb or Record Title (MusicBrainz)
      • Matched Year (MusicBrainz)
      • Matched Artist (MusicBrainz)
      • Thumbnail Image
      • Matched Release Genre Tags (MusicBrainz), fallback to Artist Genere Tags (MusicBrainz)
      • Director (If available from IMVDb)
      • Matched Album (MusicBrainz), fallback to YouTube (If available)
  • Embeds metadata into Music Video file
    • Tagged Data includes
      • Matched Title (MusicBrainz), fallback to IMVDb or Record Title (MusicBrainz)
      • Matched Year (MusicBrainz)
      • Matched Artist (MusicBrainz)
      • Matched Album Artist (MusicBrainz)
      • Thumbnail Image
      • Matched Release Genre Tags (MusicBrainz), fallback to Artist Genere Tags (MusicBrainz)
      • Matched Album (MusicBrainz), fallback to YouTube (If available)

Supported Architectures

The architectures supported by this image are:

Architecture	Tag
x86-64	latest

Version Tags

Tag	Description
latest	Newest release code

Parameters

Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate <external>:<internal> respectively. For example, -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 outside the container.

Parameter	Function
-e PUID=1000	for UserID - see below for explanation
-e PGID=1000	for GroupID - see below for explanation
-v /config	Configuration files for Lidarr.
-v /downloads-amvd	Location of music videos, also add a volume to match the location
-v /ama	Optional :: Map this to the AMA containers /config folder for proper usage
-e AUTOSTART="true"	true = Enabled :: Runs script automatically on startup
-e SCRIPTINTERVAL=1h	#s or #m or #h or #d :: s = seconds, m = minutes, h = hours, d = days :: Amount of time between each script run, when AUTOSTART is enabled
-e LidarrUrl="http://127.0.0.1:8686"	Set domain or IP to your Lidarr instance including port. If using reverse proxy, do not use a trailing slash. Ensure you specify http/s.
-e LidarrAPIkey="08d108d108d108d108d108d108d108d1"	Lidarr API key.
-e MBRAINZMIRROR="https://musicbrainz.org"	OPTIONAL :: Only change if using a different mirror
-e MBRATELIMIT=1	OPTIONAL: musicbrainz rate limit, musicbrainz allows only 1 connection per second, max setting is 10
-e SOURCE_CONNECTION=lidarr	lidarr or ama :: ama requires the AMA config folder to be mounted as a volume: /ama
-e CountryCode=us	Set the country code for preferred video matching, uses Musicbrainz Country Codes, lowercase only.
-e RequireVideoMatch=true	true = enabled :: Only keep videos that could be matched to a Musicbrainz music track.
-e subtitlelanguage="en"	Desired Language Code :: For guidence, please see youtube-dl documentation.
-e videofilter="live"	This will filter out videos Matching MusicBrainz secondary release type and album disambiguation (single word only)
-e WriteNFOs="false"	true = enabled :: Create NFO and Local Thumbnail for use in applications such as Kodi
-e USEFOLDERS=false	true = enabled :: Creates subfolders using the Lidarr Artist folder name
-e USEVIDEOFOLDERS=false	true = enabled :: Creates subfolders using Video File Name only, requires USEFOLDERS to be enabled
-e FilePermissions=644	Based on chmod linux permissions
-e FolderPermissions=755	Based on chmod linux permissions

Usage

Here are some example snippets to help you get started creating a container.

docker

docker create \
  --name=amvd \
  -v /path/to/config/files:/config \
  -v /path/to/music-videos:/downloads-amvd \
  -v /path/to/ama/config:/ama \
  -e PUID=1000 \
  -e PGID=1000 \
  -e AUTOSTART=true \
  -e SCRIPTINTERVAL=1h \
  -e SOURCE_CONNECTION=lidarr \
  -e RequireVideoMatch=true \
  -e subtitlelanguage=en \
  -e videofilter=live \
  -e USEFOLDERS=false \
  -e USEVIDEOFOLDERS=false \
  -e FilePermissions=644 \
  -e FolderPermissions=755 \
  -e MBRAINZMIRROR=https://musicbrainz.org \
  -e MBRATELIMIT=1 \
  -e LidarrUrl=http://127.0.0.1:8686 \
  -e LidarrAPIkey=LIDARRAPI \
  --restart unless-stopped \
  randomninjaatk/amvd 

docker-compose

Compatible with docker-compose v2 schemas.

version: "2.1"
services:
  amvd:
    image: randomninjaatk/amvd 
    container_name: amvd
    volumes:
      - /path/to/config/files:/config
      - /path/to/music-videos:/downloads-amvd
      - /path/to/ama/config:/ama
    environment:
      - PUID=1000
      - PGID=1000
      - AUTOSTART=true
      - SCRIPTINTERVAL=1h
      - SOURCE_CONNECTION=lidarr
      - RequireVideoMatch=true
      - subtitlelanguage=en
      - videofilter=live
      - USEFOLDERS=false
      - USEVIDEOFOLDERS=false
      - FilePermissions=644
      - FolderPermissions=755
      - MBRAINZMIRROR=https://musicbrainz.org
      - MBRATELIMIT=1
      - LidarrUrl=http://127.0.0.1:8686
      - LidarrAPIkey=LIDARRAPI
    restart: unless-stopped

Script Information

• Script will automatically run when enabled, if disabled, you will need to manually execute with the following command:
  • From Host CLI: docker exec -it amvd /bin/bash -c 'bash /config/scripts/download.bash'
  • From Docker CLI: bash /config/scripts/download.bash

Directories:

• /config/scripts
  • Contains the scripts that are run
• /config/logs
  • Contains the log output from the script
• /config/cache
  • Contains the artist data cache to speed up processes
• /config/coookies
  • Store your cookies.txt file in this location, may be required for youtube-dl to work properly

Credits

• ffmpeg
• youtube-dl
• Lidarr
• Musicbrainz
• Icons made by Freepik from www.flaticon.com