Wiedza Automatyczne Theme Music i Theme Video dla Emby / Plex / Jellyfin – Emby Theme Maker

[SiewcaRyżu]

Znowu można winić kolege z Dyskusja - Emby i radio
eżeli używacie Emby, Plex lub Jellyfin do zarządzania biblioteką seriali, to z pewnością zauważyliście, że dobrze dobrana muzyka oraz animowane tło na stronie serialu potrafią mocno poprawić wygląd biblioteki.
Trafiłem na bardzo ciekawy projekt Emby Theme Maker autorstwa Oratorian: GitHub – Oratorian/emby-theme-maker

Projekt pozwala automatycznie generować dla seriali:

• theme.mp3 – muzykę przewodnią serialu
• backdrops/theme.mp4 – krótkie wideo używane jako animowane tło

Co ważne, rozwiązanie bazuje na Intro Detection – zamiast ręcznie szukać openingów, wykorzystuje znaczniki początku i końca intro wykryte przez serwer.

Na czym polega pomysł?​

Emby podczas Intro Detection zapisuje dla odcinków informacje takie jak:

IntroStart
IntroEnd

Czyli wie mniej więcej:

00:01:32 ─────────────── 00:03:04
           OPENING

Emby Theme Maker wykorzystuje właśnie te informacje.

Dla danego serialu:

1. odczytuje znaczniki Intro Detection,
2. wybiera reprezentatywny odcinek,
3. wycina fragment pomiędzy IntroStart i IntroEnd,
4. za pomocą ffmpeg tworzy z niego plik,
5. zapisuje go w katalogu serialu,
6. wykonuje skan biblioteki.

Dzięki temu nie trzeba ręcznie szukać openingów na YouTube ani przycinać plików w programie do edycji wideo.

Co zostaje utworzone?​

Dla przykładowego serialu:

Anime/
└── Arifureta - From Commonplace to World's Strongest (2019)/
    ├── Season 01/
    │   ├── S01E01.mkv
    │   ├── S01E02.mkv
    │   └── ...
    │
    ├── theme.mp3
    │
    └── backdrops/
        └── theme.mp4

Plugin może generować trzy warianty:

Tryb	Wynik
Video	backdrops/theme.mp4
Audio	theme.mp3
Both	oba pliki

---

Theme Music​

theme.mp3 jest szczególnie przydatny, ponieważ można uzyskać automatycznie muzykę przewodnią dla praktycznie całej biblioteki anime.


Przykładowo:



Naruto/
├── theme.mp3
└── backdrops/
└── theme.mp4

Attack on Titan/
├── theme.mp3
└── backdrops/
└── theme.mp4

One Piece/
├── theme.mp3
└── backdrops/
└── theme.mp4



Zamiast ręcznie pobierać opening dla każdego anime, wykorzystujemy materiał znajdujący się już w naszej bibliotece.

Theme Video​

Druga funkcja tworzy: backdrops/theme.mp4
Czyli krótkie wideo będące fragmentem openingu.


W efekcie ekran serialu może wyglądać znacznie ciekawiej niż przy użyciu statycznego artworku.
Plugin ponownie wykorzystuje fragment oznaczony przez Intro Detection, a następnie koduje go przy pomocy ffmpeg znajdującego się już w Emby.

Największa zaleta – nie trzeba instalować ffmpeg​

W przypadku wcześniejszej wersji narzędzia CLI potrzebne były m.in.:

• Python 3.9+
• ffmpeg
• ffprobe
• API Key Emby
• dostęp do plików multimedialnych.

Plugin korzysta z:

• bazy danych Emby,
• Intro Detection,
• wbudowanego ffmpeg,
• Scheduled Tasks.

Nie potrzebujemy więc osobnego ffmpeg ani API Key.

---

Instalacja w Emby​

Projekt jest obecnie dostępny jako plugin Emby.
Pobieramy: EmbyThemeMaker.dll
z najnowszego release:
Emby Theme Maker – Releases

Następnie kopiujemy DLL do katalogu pluginów Emby.

Linux​

/var/lib/emby/plugins/

Windows
…\Emby-Server\programdata\plugins\

Następnie restartujemy Emby.

Konfiguracja​

Po instalacji w Dashboard powinien pojawić się:

Dashboard
   └── Theme Maker

Plugin pozwala skonfigurować m.in.:

• Video / Audio / Both
• nadpisywanie istniejących theme
• katalog, w którym ma działać
• limit liczby seriali
• sposób wyboru odcinka
• minimalną i maksymalną długość intro
• padding przed/po intro
• preferowany język audio
• jakość video
• bitrate
• fade in / fade out
• liczbę równoległych procesów ffmpeg
• automatyczny scan biblioteki.

Najpierw Preview!​

Bardzo fajna funkcja to:
Theme Maker: Preview
Preview jest trybem read-only - nie tworzy żadnych plików, ale pokazuje w logach, co plugin zamierza zrobić dla poszczególnych seriali:

• jaki odcinek został wybrany,
• jakie są znaczniki intro,
• czy theme już istnieje,
• czy dany serial może zostać przetworzony.

Dopiero później uruchamiamy:
Theme Maker: Generate
które faktycznie tworzy pliki.


Moim zdaniem warto zawsze najpierw uruchomić Preview – szczególnie przy dużej bibliotece na QNAP.

Można również uruchomić automatycznie​

Plugin korzysta z:
Dashboard → Scheduled Tasks
Można więc ustawić np.:
Theme Maker: Generate
↓
raz dziennie
i po dodaniu nowych seriali system będzie mógł automatycznie uzupełniać brakujące:

theme.mp3
theme.mp4

Plugin domyślnie nie nadpisuje istniejących plików, dzięki czemu kolejne uruchomienia nie powinny niepotrzebnie ponownie kodować całej biblioteki.