lidarr-on-steroids/README.md

106 lines
4.8 KiB
Markdown

# [lidarr-on-steroids](https://github.com/youegraillot/lidarr-on-steroids/)
```I'm looking for maintainers, pm me if you're interested !```
[![GitHub last commit](https://img.shields.io/github/last-commit/youegraillot/lidarr-on-steroids?style=for-the-badge&logo=github)](https://github.com/youegraillot/lidarr-on-steroids)
[![Latest tag](https://img.shields.io/docker/v/youegraillot/lidarr-on-steroids?style=for-the-badge&logo=docker)](https://hub.docker.com/r/youegraillot/lidarr-on-steroids)
[![Docker pulls](https://img.shields.io/docker/pulls/youegraillot/lidarr-on-steroids?style=for-the-badge&logo=docker)](https://hub.docker.com/r/youegraillot/lidarr-on-steroids)
This repository bundles a modded version of Lidarr and Deemix into a docker image featuring :
- Native Deemix integration as an indexer and downloader for Lidarr
- Automatic Lidarr and Deemix configuration
- Automatic conversion from any format with ffmpeg
- Podman compatibility with rootless mode
This allows an easy deployment, with the advantage of having a direct control over Deemix indexing and downloader capacities into Lidarr :
!["Lidarr indexers"](https://github.com/youegraillot/lidarr-on-steroids/raw/main/.assets/lidarr-indexers.png "Lidarr indexers")
## Usage
### Parameters
| Parameter | Function |
| :----: | --- |
| `-p 8686` | Lidarr WebUI |
| `-p 6595` | Deemix WebUI |
| `-e PUID=1000` | for UserID |
| `-e PGID=1000` | for GroupID |
| `-e AUTOCONFIG=true` | Enable automatic configuration - see below for explanation |
| `-e FLAC2CUSTOM_ARGS=""` | Sets arguments used when calling flac2custom.sh |
| `-e CLEAN_DOWNLOADS=true` | Enable cleaning empty folders in /downloads |
| `-v /config` | Configuration files for Lidarr. |
| `-v /config_deemix` | Configuration files for Deemix. |
| `-v /downloads` | Path to your download folder for music. |
| `-v /music` | Music files. |
### Docker Run
```sh
docker run \
--name lidarr \
-p 8686:8686 \
-p 6595:6595 \
-v <path>:/config \
-v <path>:/config_deemix \
-v <path>:/downloads \
-v <path>:/music \
--restart unless-stopped \
youegraillot/lidarr-on-steroids
```
### Docker Compose
```yml
version: "3"
services:
lidarr:
image: youegraillot/lidarr-on-steroids
restart: unless-stopped
ports:
- "8686:8686" # Lidarr web UI
- "6595:6595" # Deemix web UI
volumes:
- <path>:/config
- <path>:/config_deemix
- <path>:/downloads
- <path>:/music
```
## Automatic configuration
Deemix comes with optimal settings allowing Lidarr integration, in particular regarding the folder structure ("createCDFolder" is required for this to work). `DEEMIX_SINGLE_USER` environment variable is also set to `true` to allow the `setup` script to read the corresponding ARL.
The `setup` service will install the Deemix plugin. This requires Lidarr to be restarted once.
In `AUTOCONFIG` mode (default), the only manual manipulation you'll only have to fill your Deezer credentials in Deemix web UI (port [6595](http://localhost:6595) by default). Once the `/config_deemix/login.json` is filled with the resulting ARL, the `setup` will be able to create the following :
- /music root folder if no other root folder is configured
- Delay profile allowing Deemix to be used by automatic search
- Deemix as an indexer
- Deemix as a download client
- Flac2Custom script connection if `FLAC2CUSTOM_ARGS` is set
- clean-downloads script connection to keep your downloads folder *clean* after each imports
In case you don't want the automagical part (which is really the only value of this image), just set `AUTOCONFIG` environment variable to `false`.
## Audio files conversion
The image uses a modded version of lidarr-flac2mp3 allowing conversion from any format.
To enable conversion on Lidarr import, create a new Connection to a Custom Script. You can also provide your own custom conversion script, see [lidarr-flac2mp3](https://github.com/youegraillot/lidarr-flac2mp3) for more information.
In `AUTOCONFIG`, if `FLAC2CUSTOM_ARGS` is set and no other connection to flac2* is found, this step done for you :
!["Lidarr custom script settings"](https://github.com/youegraillot/lidarr-on-steroids/raw/main/.assets/lidarr-custom-script.png "Lidarr custom script settings")
## Acknowledgment
This project is just a compilation of various tools made possible by these projects :
- [Lidarr](https://github.com/Lidarr/Lidarr) and especially [ta264](https://github.com/ta264) for the plugin integration
- [lidarr-flac2mp3](https://github.com/TheCaptain989/lidarr-flac2mp3) for the format conversion script
- [Deemix](https://deemix.app/) for the downloader backend
- [hotio](https://hotio.dev/) for the base docker image
Alternatively, you could use [Deemixrr](https://github.com/TheUltimateC0der/deemixrr) which pretty much offers the same functionalities without the *starr of the various Sonarr forks.