Package: tatorter
“tatorter” is a simple script to rename video files of the German police crime drama television series “Tatort” to a standardized file name format.
That makes it a lot easier to archive local copies of the episodes which may come from various sources with different and/or insufficient naming schemes.
The used information such as episode indexes and detective team is fetched from the list of episodes on the German Wikipedia.
For each video file to be renamed, tatorter uses an easy heuristic with some fuzzy string matching to find the 5 best fitting episodes and to rename the file
according to the user’s choice.GitHub page:https://github.com/DLFW/tatortertatorter depends on Python 3 and can be installed withpip.Since tatorter can handle only the original German episode names, the rest of this documentation is also written in German. :)Deutsch„tatorter“ ist einfaches Skript um lokale Videodateien der Serie „Tatort“ automatisch umzubenennen und so ein ein einheitliches Dateinamensschema für alle Videos zu erhalten.
Das macht die Archivierung einfacher und erhöht die Übersichtlichkeit der Sammlung.
Die notwendigen Daten wie Episodennummer und Ermittlerteam werden dabei aus der deutschen Wikipedia bezogen.
Für jede Videodatei, die umbenannt werden soll, ermittelt tatorter die fünf besten Episoden-Treffer durch eine Heuristik mit Fuzzy-String-Suche. Der Anwender wählt dann
den passenden Treffer aus.Erhält man Tatort-Videos beispielsweise aus der ARD-Mediathek, haben diese oft Namen wieTatort Auf einen Schlag MDR Fernsehen Video ARD Mediathek.mp4.
tatorter würde für diese Datei etwa folgende Umbenennungsvorschläge machen:================================================================================
Choose new name for "Tatort Auf einen Schlag MDR Fernsehen Video ARD Mediathek.mp4"
––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
    1  (84%)| 0978--Dresden--Auf einen Schlag--(Sieland, Gorniak, Mohr und Schnabel).mp4
––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
    2  (63%)| 0185--[Stoever und Brockmöller]--Tod auf Eis--(Stoever und Brockmöller).mp4
––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
    3  (57%)| 1027--Stuttgart--Stau--(Lannert und Bootz).mp4
––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
    4  (53%)| 0588--[Ehrlicher und Kain]--Feuertaufe--(Ehrlicher und Kain).mp4
––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
    5  (51%)| 0391--[Ehrlicher und Kain]--Tanz auf dem Hochseil--(Ehrlicher und Kain).mp4
––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––Dabei wird je ein Index (hier von 1 bis 5), eine Trefferquote (als Prozentangabe) und der zur Wahl stehende neue Dateiname angezeigt.Verwendung„tatorter“ benötigt Python 3. Die Installation kann mitpipvorgenommen werden (pip3 install tatorter).Das Skript ist nur unter Linux getestet. Durch die Windows-Dateisysteme werden unter Windows viele Umbenennungen fehlschlagen, da viele
Tator-Titel Zeichen enthalten, die unter Windows nicht in Dateinamen erlaubt sind.NoteFürLinuxgilt: Wird ein Paket nicht als „root“ installiert, kann es je nach Distribution sein,
dass das Python-Skript später nicht direkt aufgerufen kann.FürWindowsrelevant: Es steht neben dem Skripttatorterauch ein identisches Skript mit
dem Namentatorter.pyzur Verfügung, welches auch für Windows als Python3-Skript zu erkennen ist,
sofern die Dateiendung mit dem Python3-Interpreter verknüpft ist.„tatorter“ wird als Python-Skript installiert und kann damit typischerweise systemweit aufgerufen werde.
Die umzubenennenen Dateien müssen mit Dateinamen oder „Globbing“-Dateinamenmuster mit „*“ und „?“ und „[…]“ als Platzhaltern als Argument übergeben werden.
Etwatatorter Schwanensee\ Tatort\ Video\ ARD\ Mediathek.mp4odertatorter *.mp4.Für alle passenden Dateien werden anschließend Namensvorschläge ermittelt. Die besten fünf Treffer stehen dann jeweils zur Auswahl.Beim ersten Start  werden die notwendigen Information von derListe der Tatort-Folgender deutschen Wikipedia bezogen und in einer Cache-Datei.tatorter.cacheim Heimverzeichnis abgelegt.
Ist dieser Cache älter als 24 Stunden wird er verworfen und die Daten erneut aus der Wikipedia bezogen.
Mit der Option-ckann eine andere Cache-Datei gewählt werden.
Die Option-rforciert ein Update des Cache, egal wann dieser zuletzt aktulaisiert wurde.
Mit der Option-pkann ein anderes Namensschema gewählt werden.Die Voreinstellung für das Namensschema lautet derzeit{episode_index:0>4}--{location}--{title}--({team}), wobeilocationder Heimatstadt/-region des jeweiligen Ermittlerteams entspricht.
Die Heimatstadt ist die einzige Information die nicht direkt aus der Wikipedia stammt, sondern anhand eines
Mappings (team_to_locationingrabber.py) aus dem Team abgeleitet wird. Derzeit sind alle Heimatstädte ab Episode 800 dort
verzeichnet. Fehlen hier relevante „locations“, müssten diese händisch nachgetragen werden.WarningManuelle Änderungen an den Quellen werden bei einem Update viapipüberschrieben!Insgesamt stehen die folgenden Variablen für das Namensschema zur Verfügung:episode_index: Episodenindexlocation: Heimatstadt/-region des Ermittlerteamstitle: Titel der Episodebroadcaster: Produzierende Rundfunkanstaltpremiere: Datum der Erstaustrahlungteam: Ermittlerteamcase_index: Fall-Nummer des jeweiligen Ermittlerteamsauthor: Autor der Episodedirector: Regisseur der Episodeseason: Jahr der Erstausstrahlungepisode: Laufende Episode im JahrGitHub-Seite:https://github.com/DLFW/tatortertatorter steht unter derGNU General Public License, Version 3 (GPL 3).tatorter is a free and open project, you can redistribute it and/or modify
it under the terms of theGNU General Public Licenseas published by
the Free Software Foundation, either version 3 of the License, or any later version.tatorter is distributed in the hope that it will be useful,
but without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.  See the
GNU General Public License for more details.