DeepFilm

Important Notice: Since DeepFilm is a service which provides access to movies from German TV, the documentation is also kept in the respective language.

DeepFilm v5 ist ein kostenloser Dienst von RunStorage, der es Dir ermöglicht alle Filme aus dem öffentlich-rechtlichen Fernsehen online anzusehen, in der Cloud zu speichern oder herunterzuladen. DeepFilm ist unter https://deepfilm.de verfügbar. Bei Fragen, sind wir jeder Zeit für Dich da: Kontakt.

Inhaltsverzeichnis

In der unten stehenden Tabelle findest Du die Themen dieser Dokumentation. Klicke einfach auf ein Thema um mehr zu erfahren.

Thema Beschreibung
Login Bei DeepFilm wird "Login mit Google" verwendet, um ein schnelles und sicheres Account-System anzubieten.
Konzept Wir verfolgen bei der Entwicklung von DeepFilm einen ganz bestimmten Leitfaden.
Suche DeepFilm besitzt eine Schnell-Suche und eine anpassbare Variante: die Eweiterte Suche.
Meine Bibliothek Mit DeepFilm kannst Du Filme z.B. zum späteren Ansehen kostenlos in der Cloud speichern.
Filmdetails Jeder Film erhält bei DeepFilm seine eigene Detail-Seite, auf der alle Informationen zusammengefasst werden.
Filmliste Die Filmliste ist das Fundament des DeepFilm-Dienstes. Sie enthält alle Filme des öffentlich-rechtlichen Fernsehens.
Data API Für Entwickler, bieten wir Zugriff auf unsere interne Schnittstelle von DeepFilm.

Login

Bei DeepFilm kannst Du Dich mit Deinem Google Konto einloggen. Dies vereinfacht den Login-Vorgang und verhindert, dass Du Dir eine weitere Benutzername/Passwort-Kombination merken musst. Beim Verbinden von DeepFilm mit Deinem Google Konto, benötigen wir die Berechtigung Basis-Konto-Informationen, mit der wir in der Lage sind Deinen Name und Deine E-Mail-Adresse zu lesen. Diese Informationen bzw. Daten werden nach unserer Privacy Policy gespeichert und nur zur Bereitstellung des Dienstes verwendet. Dritte erhalten keinen Zugriff auf Deine Informationen.

Eine Login-Session besteht ein Jahr, d.h. Du musst Dich nur ein Mal alle 365 Tage einloggen. Zum Login oder Wechsel des aktuellen Kontos, bitte besuche einfach https://deepfilm.de/auth.

Konzept

Das Konzept bzw. der Leitfaden von DeepFilm ist einfach. Es geht uns darum, die unten aufgeführten Funktionen kostenlos und so nutzerfreundlich wie möglich umzusetzen. Dies bedeutet z.B. dass unsere Website responsive (d.h Handy-freundlich) und sehr schnell (Tier 3+ Rechenzentrum; nur SSD; Gigabit-Internet; etc.) ist.

Kern-Features:

Suche

DeepFilm bietet zwei verschiedene Suchfunktionen. Die Schnell-Suche ist auf der Startseite und rechts oben auf jeder Seite des Webauftritts zu finden. Sie durchsucht die Tags aller Filme und zeigt die Ergebinsse in Listen-Form an. Solltest Du allerdings genauer Filtern wollen, kannst Du die Erweiterte Suche verwenden. Sie ist auf der Startseite unter dem Pfeil-Nach-Unten-Symbol platziert. Klicke einfach auf diesen Button und das Formular zur erweiterten Suche wird sich öffnen. Was die einzelnen Felder bedeuten ist in der unten stehenden Tabelle erklärt. Wenn Du z.B. nicht mit dem Sendedatum filtern möchtest d.h. Dir das Sendedatum egal ist, kannst Du das entsprechende Feld einfach unausgefüllt bzw. leer lassen.

Feld Bedeutung
Sender Hier kannst Du die Suchergebnisse auf einen bestimmten der 20 unterstützten Sender (ZDF, ARD, RBB, HR, SRF.Podcast, SRF, BR, NDR, ARTE.DE, ZDF-tivi, ARTE.FR, SWR, KiKA, WDR, MDR, 3Sat, ORF, PHOENIX, SR, DW) einschränken.
Normaler Suchbegriff Dieses Feld kann einen Suchbegriff beinhalten, wie Du ihn in die Schnell-Suche eingeben kannst. Das bedeutet, dass die Tags aller Suchergebnisse durchsucht werden. Trennzeichen ist das Leerzeichen. Die Reihenfolge der Tags oder die Groß-/Kleinschreibung spielen keine Rolle.
Titel Hiermit können die Titel der entsprechenden Filme durchsucht werden. Der Text, der hier eingeben wird muss, abgesehen von der Groß-/Kleinschreibung exakt so im Film-Titel vorkommen.
Beschreibung Das Beschreibungs-Feld kann Wörter enthalten, die in der Film-Beschreibung auftreten müssen. Ähnlich zum Normaler Suchbegriff-Feld, spielen die Reihenfolge der Wörter oder die Groß-/Kleinschreibung keine Rolle.
Sendedatum Wenn die Sendedatum-Felder ausgefüllt werden, so werden nur Filme durchsucht, die am gegebenen Tag im Fernsehen ausgestrahlt wurden. Die drei Felder (Tag, Monat, Jahr) müssen mit führenden Nullen bzw. im Format DD.MM.YYYY gefüllt werden. Das Datum 3.1.2018 oder 03.1.18 wäre also ungültig, der 03.01.2018 hingegen würde funktionieren.
Minimale Länge Hier kannst Du die Suchergebnisse auf Filme mit einer gegebenen minimalen Länge filtern. Die Felder müssen im Format H:MM:SS (z.B. 0:14:50 oder 1:20:00) ausgefüllt werden. Der maximale Wert liegt bei 2 Stunden und 5 Minuten.

Solltest Du z.B. von unserem Support oder von einer anderen Person eine Film-ID erhalten, so kannst Du mit dem Formular darunter nach ihr suchen. Film-IDs sind immer Ganzzahlen mit mindestens zwei und maximal elf Ziffern, die in bestimmten Fällen mit dem Buchstaben c eingeleitet werden. Sollte letzteres zutreffen, so ist der Film an einen Account gebunden und darf nicht geteilt werden.

Meine Bibliothek

Die eigene Bibliothek von DeepFilm beinhaltet die Filme, die Du kostenlos in die Cloud speicherst. Letzteres ist möglich, indem Du auf der Detail-Seite auf das Plus-Symbol + klickst. Der Film wird dann in Deiner Bibliothek gespeichert. Alle Filme, die in Deiner Bibliothek gespeichert sind, kannst Du unter https://deepfilm.de/cloud einsehen. Für Filme in deiner Bibliothek kannst Du die Such-Tags auf der Film-Detail-Seite ändern. Sie werden mit Semikolon getrennt. Mehr Informationen findest Du im Tags ändern-Fenster.

Filmdetails

Wenn Du an einem beliebigen Ort in der DeepFilm-Webanwendung auf einen Filmtitel klickst, so gelangst Du auf die Detail-Seite für diesen Film. Dort kannst Du sofern der Film in Deiner Bibliothek ist, die Such-Tags ändern. Anderfalls kannst Du ihn Deiner Bibliothek hinzufügen. Auf der Detail-Seite sind drei Boxen mit den folgenden Informationen zu finden:

Filmdetails:

Datum:

Beschreibung:

Zudem besteht auf der Detail-Seite selbstverständlich die Möglichkeit zur Wiedergabe des entsprechenden Films.

Filmliste

Die Filmliste von DeepFilm ist eine Datenbank von ca. 50.000 bis 60.000 Einträgen, die die aktuellen Filme der öffentlich-rechtlichen Sender beinhaltet. Sie wird im Normalfall acht Mal täglich aktualisiert. Hierbei werden Filme, die von den Sendern entfernt wurden aus der Datenbank gelöscht (Filme in Meine Bibliothek bleiben bestehen) und neue hinzugefügt. Auf die Filmliste kann über unseren Web-Dienst unter https://deepfilm.de oder über die Data API zugegriffen werden.

Data API

Die DeepFilm Data API ist unter dem Hostnamen deepfilm-v5.runstorageapis.com verfügbar. Es werden nur Port 443 bzw. HTTPS-Verbindungen unterstützt. Eine Beispiel-Anfrage ist unten zu sehen:

$ curl "https://deepfilm-v5.runstorageapis.com/list?info"
{
    "movies": [
        {
            "id": "282423",
            "broadcaster": "ARD",
            "title": "Folgen 37 bis 40",
            "length": "1020",
            "status": "PUBLIC",
            "tags": "ard;folgen 37 bis 40;mann\/frau;07.06.2018"
        },
        [...]
    ],
    "info": [
        "57869"
    ],
    "success": true
}

Eine Auflistung aller API-Funktionen ist unter https://deepfilm-v5.runstorageapis.com/help.json möglich. Details über die konkrete Verwendung der API sind unter https://github.com/runstorage/deepfilm/tree/master/api zu finden.