docker-lidarr-lad icon indicating copy to clipboard operation
docker-lidarr-lad copied to clipboard

Official docker for LAD bash enhancement script

Deprecated

This repository is now deprecated, will no longer be updated and is being set to archived. The script used for this container has been split into multiple scripts going forward to simplify maintenance.

  • For Lidarr: https://github.com/linuxserver/docker-lidarr (Preview Tag, same version of Lidarr used fo this container...)
  • For Audio: https://github.com/RandomNinjaAtk/docker-amd
  • For Videos: https://github.com/RandomNinjaAtk/docker-amvd

Migration info:

https://github.com/RandomNinjaAtk/docker-lidarr-lad/wiki/Migration

RandomNinjaAtk/lidarr-lad

Lidarr is a music collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new tracks from your favorite artists and will grab, sort and rename them. It can also be configured to automatically upgrade the quality of files already downloaded when a better quality format becomes available.

Lidarr-Automated-Downloader (LAD) is a open-source script that is integrated into this container

This containers base image is provided by: linuxserver/lidarr:preview

lidarr

Supported Architectures

The architectures supported by this image are:

Architecture Tag
x86-64 amd64-latest

Version Tags

Tag Description
latest Lidarr Nightly releases

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
-p 8686 Application WebUI
-e PUID=1000 for UserID - see below for explanation
-e PGID=1000 for GroupID - see below for explanation
-e TZ=Europe/London Specify a timezone to use EG Europe/London.
-e UMASK_SET=022 control permissions of files and directories created by Lidarr.
-v /config Configuration files for Lidarr.
-v /storage Path to your download and music folder. (DO NOT DELETE, this is a required path)
-e VIDEOPATH="/path/to/vides" Location of music videos
-e LidarrUrl="http://127.0.0.1:8686" OPTIONAL :: Only needed if utilizing "URL Base" option
-e MBRAINZMIRROR="https://musicbrainz.org" OPTIONAL :: Only change if using a different mirror
-e DLMODE="Audio" Both or Audio or Video :: "Both" downloads audio and videos; "Audio" downlods only audio files; "Video" only downloads video files
-e AMODE="wanted" wanted or archive :: wanted mode processes Lidarr Wanted/Cutoff Album lists (TrackUpgrade must be enabled for Cutoff) :: archive mode downloads all albums for an aritst, no lidarr matching is used for importing, keeps everything... WARNING: When using archive mode, do not rename album folders or you will continuely re-download available albums...
-e IMODE="match" match or forced or manual :: "match" uses lidarr's matching engine to import; "forced" moves the download into the Lidarr artist directory; "manual" downloads are left in the temp import directory for you to manual import
-e TRACKUPGRADE=false true = Enabled :: Upgrades existing tracks to requested format. wanted mode is controlled by cutoff album list and archive mode is detected automatically. Recommend disabling for archive mode, unless your changing your format.
-e ENABLE_LAD=TRUE TRUE = Enabled :: Runs LAD script automatically every 15 minutes via cronjob
-e ARL_TOKEN="" User token for dl client, for instructions to obtain token: https://notabug.org/RemixDevs/DeezloaderRemix/wiki/Login+via+userToken#how-do-i-get-my-usertoken
-e CONCURRENCY=4 Number of concurrent tracks to download via the client. Increasing can speed things up but is more resource intensive, lower is safer...
-e VerifyTrackCount=true true = enabled :: This will verify album track count vs dl track count, if tracks are found missing, it will skip import...
-e amount=1000000000 Maximum: 1000000000 :: Number of missing/cutoff albums to look for...
-e quality=MP3 SET TO: FLAC or MP3 or OPUS or AAC or ALAC
-e ConversionBitrate=320 FLAC -> OPUS/AAC will be converted using this bitrate
-e ReplaygainTagging=false TRUE = ENABLED :: adds replaygain tags for compatible players (FLAC ONLY)
-e FolderPermissions=777 Based on chmod linux permissions
-e FilePermissions=666 Based on chmod linux permissions
-e DownLoadArtistArtwork=true true = enabled :: Uses Lidarr Artist artwork first with a fallback using LAD as the source
-e TagWithBeets=true true = enabled :: enable beet tagging to improve matching accuracy
-e RequireQuality=false true = enabled :: skips importing files that do not match quality settings
-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 videoformat="--format bestvideo[vcodec*=avc1]+bestaudio[ext=m4a]" For guidence, please see youtube-dl documentation
-e subtitlelanguage="en" Desired Language Code :: For guidence, please see youtube-dl documentation.

videoformat

LAD Information

  • Script is scheduled to run every 15 minutes via a cron job

Directories:

  • /storage/downloads/lidarr/dlclient
    • DL client temporary DL directory
  • /storage/downloads/lidarr/lidarr-import
    • lidarr directory used for automated imports
  • /config/scripts
  • /config/scripts/cache
    • Contains all cached album-lists to speed up results

Files:

  • lidarr-automated-downloader.bash
    • LAD script, this file is updated on every image update
  • cron-job.log
    • Log of last attempt to execute
  • script-run.log
    • Current log of script run, can be seen in normal docker log
  • notfound.log
    • Log file containing list of albums that could not be found using normal or fuzzy matching, automatically cleared every Saturday via cron
  • musicbrainzerror.log
    • Log file containing list of artists without links, open log for more details
  • imvdberror.log
    • Log file containing list of artists without links to IMVDb, open log for more details
  • download.log
    • Log file containing list of albums that were downloaded, automatically cleared every Saturday via cron
  • beets-config.yaml
    • Beet config file for matching
  • beets-library.blb
    • Beet library file, do not touch
  • artwork.bash
    • Custom embedded ablum artwork extraction script to be added to Lidarr as a custom script, see Lidarr Recommendations below

Lidarr Configuration Recommendations

Media Management Settings:

  • Disable Track Naming
    • Disabling track renaming enables synced lyrics that are imported as extras to be utilized by media players that support using them

Track Naming:

  • Artist Folder: {Artist Name}{ (Artist Disambiguation)}
  • Album Folder: {Artist Name}{ - ALBUM TYPE}{ - Release Year} - {Album Title}{ ( Album Disambiguation)}

Importing:

  • Enable Import Extra Files
    • lrc,jpg,png

File Management

  • Change File Date: Album Release Date

Permissions

  • Enable Set Permissions

Connect Settings

Add Custom Script

  • Settings -> Connect -> + Add -> custom Script
Parameter Value
Name Album Artwork Extractor
On Grab No
On Release Import Yes
On Upgrade Yes
On Download Failure No
On Import Failure No
On Rename Yes
On Track Retag Yes
On Health Issue No
Tags leave blank
Path /config/scripts/artwork.bash

This script will extract the embedded file artwork and store it in the local ablum folder