Sanitized mirror from private repository - 2026-04-20 01:32:01 UTC

2026-04-20 01:32:01 +00:00
commit e7652c8dab
1445 changed files with 364095 additions and 0 deletions
--- a/docs/guides/LIDARR_DEEZER_MONITORING.md
+++ b/docs/guides/LIDARR_DEEZER_MONITORING.md
@@ -0,0 +1,149 @@
+# Lidarr / Deezer Monitoring Guide
+
+Quick reference for checking what arr-scripts is doing and managing downloads.
+
+## How it works
+
+The `Audio` service runs continuously inside the Lidarr container. Every cycle it:
+1. Asks Lidarr for missing albums
+2. Searches Deezer for each one using fuzzy title matching
+3. Downloads matches via deemix (320kbps MP3)
+4. Notifies Lidarr to import the files
+
+You do nothing — it runs in the background forever.
+
+---
+
+## Watching it live
+
+**Via Portainer** (easiest):
+Portainer → Containers → `lidarr` → Logs → enable Auto-refresh
+
+**Via SSH:**
+```bash
+ssh atlantis
+DOCKER=/var/packages/REDACTED_APP_PASSWORD/target/usr/bin/docker
+sudo $DOCKER logs lidarr -f
+```
+
+**Reading the log lines:**
+```
+1 :: missing :: 47 of 984 :: Emis Killa :: 17 :: Getting Album info...
+                 ^^^^^^^^^^                        → searching Deezer
+
+:: Deezer MATCH Found :: Calculated Difference = 0
+                                                   → found it, downloading next
+
+[album_123] Emis Killa - GOAT :: Track downloaded.
+                                                   → deemix downloading track by track
+
+LIDARR IMPORT NOTIFICATION SENT! :: /config/extended/import/Emis Killa-17 (2021)
+                                                   → done, Lidarr importing it
+```
+
+**Check current position (without tailing):**
+```bash
+ssh atlantis "DOCKER=/var/packages/REDACTED_APP_PASSWORD/target/usr/bin/docker && sudo \$DOCKER exec lidarr sh -c 'ls -t /config/logs/Audio-*.txt | head -1 | xargs tail -5'"
+```
+
+---
+
+## Checking if an album downloaded
+
+Go to **Lidarr UI** → `http://192.168.0.200:8686` → search the artist → the album should show track files filled in (green) instead of missing (red/grey).
+
+Or via API:
+```bash
+# Get track file count for an artist by name
+curl -s 'http://192.168.0.200:8686/api/v1/artist?apikey=REDACTED_API_KEY | \
+  python3 -c "
+import sys, json
+artists = json.load(sys.stdin)
+for a in artists:
+    if 'emis' in a.get('artistName','').lower():
+        s = a.get('statistics', {})
+        print(a['artistName'], '-', s.get('trackFileCount',0), '/', s.get('totalTrackCount',0), 'tracks')
+"
+```
+
+---
+
+## Pausing and resuming downloads
+
+**Quick pause (until next restart):**
+```bash
+# Via Portainer → Containers → lidarr → Console → Connect
+s6-svc -d /run/service/custom-svc-Audio
+
+# Resume
+s6-svc -u /run/service/custom-svc-Audio
+```
+
+**Permanent pause (survives restarts):**
+1. Edit `/volume2/metadata/docker2/lidarr/extended.conf` on Atlantis
+2. Set `enableAudio="false"`
+3. Restart the lidarr container
+
+---
+
+## Checking where it is in the queue
+
+The queue is sorted newest-release-date first. To find where a specific artist sits:
+
+```bash
+curl -s 'http://192.168.0.200:8686/api/v1/wanted/missing?page=1&pagesize=1000&sortKey=releaseDate&sortDirection=descending&apikey=REDACTED_API_KEY | \
+  python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+for i, r in enumerate(data.get('records', [])):
+    artist = r.get('artist', {}).get('artistName', '')
+    if 'emis' in artist.lower():  # change this filter
+        print(f'pos {i+1}: {r[\"releaseDate\"][:10]} | {artist} - {r[\"title\"]}')
+"
+```
+
+---
+
+## Checking if the ARL token is still valid
+
+The ARL token expires roughly every 3 months. Signs it's expired: downloads silently fail or deemix returns 0 tracks.
+
+**Check ARLChecker log:**
+```bash
+ssh atlantis "DOCKER=/var/packages/REDACTED_APP_PASSWORD/target/usr/bin/docker && sudo \$DOCKER exec lidarr sh -c 'ls -t /config/logs/ARLChecker-*.txt | head -1 | xargs cat'"
+```
+
+**Renew the token:**
+1. Log in to deezer.com in a browser
+2. Open DevTools (F12) → Application tab → Cookies → `deezer.com` → find the `arl` cookie → copy the value
+3. On Atlantis, edit `/volume2/metadata/docker2/lidarr/extended.conf`
+4. Update the `arlToken="..."` line
+5. Restart the container: Portainer → Containers → `lidarr` → Restart
+
+---
+
+## Service health check
+
+```bash
+# Are all arr-scripts services running?
+# Via Portainer console exec into lidarr:
+s6-svstat /run/service/custom-svc-Audio
+s6-svstat /run/service/custom-svc-ARLChecker
+s6-svstat /run/service/custom-svc-QueueCleaner
+s6-svstat /run/service/custom-svc-AutoConfig
+
+# Per-service log files
+ls /config/logs/
+```
+
+---
+
+## What the log errors mean
+
+| Error | Meaning | Action |
+|-------|---------|--------|
+| `is not ready, sleeping until valid response...` | Scripts can't reach Lidarr API — usually from a stale start | Restart container |
+| `ERROR :: download failed, missing tracks...` | deemix returned 0 files — ARL token expired or album unavailable in region | Renew ARL token |
+| `ERROR :: Unable to match using beets...` | Beets couldn't tag against MusicBrainz | Non-critical, import still proceeds |
+| `ERROR :: No results found via Fuzzy Search...` | Album not on Deezer | Nothing to do, script moves on |
+| `Calculated Difference () greater than 3` | pyxdameraulevenshtein broken | See [common-issues.md](../troubleshooting/common-issues.md#arr-scripts-lidarr-deezer) |