jellyfin-konverter

Et macOS-script som konverterer MKV-filer til Jellyfin-optimalisert format ved hjelp av HandBrakeCLI. Behandler både filmer og serier automatisk med retry-logikk og ntfy-varsling.

---

Hvordan det fungerer

Scriptet gjør to ting:

1. Filmer — Finner MKV-filer i filmmapper, konverterer til ny fil, verifiserer størrelse, sletter original ved suksess.

2. Serier — Finner MKV-episoder rekursivt, konverterer til .tmp.mkv, erstatter original med mv ved suksess, og oppretter en .done-markørfil for å unngå dobbelkonvertering.

Funksjoner

• Opptil 3 automatiske forsøk per fil ved feil
• Størrelsessjekk — krever minimum 100 MB for å godkjenne konvertering
• Halvferdige filer oppdages og konverteres på nytt
• Hopper over allerede konverterte filer
• Bevarer alle lydspor og undertekster
• Varsler via ntfy ved start, fullføring og feil

Krav

• macOS
• HandBrakeCLI installert i /usr/local/bin/
• no_burn.json preset-fil (se steg 3)
• ntfy-server

Installasjon

Steg 1 — Last ned HandBrakeCLI

Gå til handbrake.fr/downloads2.php og last ned HandBrakeCLI for macOS. Pakk ut og flytt til /usr/local/bin/:

sudo mv HandBrakeCLI /usr/local/bin/
chmod +x /usr/local/bin/HandBrakeCLI

Steg 2 — Klon repoet

git clone https://git.grandedata.no/GrandeData/jellyfin-konverter
cd jellyfin-konverter

Steg 3 — Legg inn preset-filen

Kopier no_burn.json til skrivebordet, eller oppdater PRESET_FIL-variabelen i scriptet til der filen ligger.

Steg 4 — Konfigurer scriptet

Åpne konverter_filmer.sh og rediger variablene øverst:

HANDBRAKE="/usr/local/bin/HandBrakeCLI"
FILM_MAPPE="/Volumes/jellyfin/Filmer"
SERIE_MAPPE="/Volumes/jellyfin/Serier"
PRESET_FIL="$HOME/Desktop/no_burn.json"
NTFY_URL="https://ntfy.grandedata.no/GrandeData"

Steg 5 — Gjør scriptet kjørbart

chmod +x konverter_filmer.sh

Steg 6 — Kjør

./konverter_filmer.sh

Filer

Fil	Beskrivelse
konverter_filmer.sh	Hovedscriptet
no_burn.json	HandBrake preset — bevarer lydspor og undertekster uten innbrenning

Logging

Scriptet logger til terminalen og sender varsler via ntfy:

• 🎬 Når konvertering starter
• ✅ Når fil er ferdig og original er slettet/erstattet
• ⚠️ Ved mislykket forsøk
• ❌ Ved total feil etter alle forsøk
• 🏁 Når alt er fullført

Infrastruktur

Kjøres lokalt på Mac mot Jellyfin-disken montert via SMB. HandBrakeCLI kjører én konvertering av gangen for å spare diskplass.