# Humicorn — Content-Import

Du laedst hier Bilder, Videos und Textwitze in den Humicorn-Katalog.
Nichts wird sofort veroeffentlicht: alles landet in einem Eingang und geht
erst nach Pruefung und Duplikat-Abgleich in den Bestand.

## Zugangsdaten

Stehen NICHT auf dieser Seite. Sie kommen mit deinem Auftrag. Fehlen sie
dir, frag die Person, die dich beauftragt hat — rate nicht und probiere
nichts durch.

## So gehst du vor

1. Sprache des Materials bestimmen (siehe unten — das ist die eine
   Angabe, die wirklich zaehlt).
2. Ordner anlegen: <sprache>/<quelle>, z. B. de/nichtlustig
3. Dateien hineinlegen.
4. Wenn du Titel, Tags oder Zahlen JE DATEI hast: manifest.csv dazu.
   Wenn Angaben fuer den ganzen Schwung gelten: _defaults.meta dazu.
5. Hochladen (FTP oder HTTPS, beides unten).
6. Fertig. Der Import laeuft von selbst, hoechstens zehn Minuten spaeter.

Du kannst den Katalog NICHT abfragen — es gibt keinen Lese-Zugang. Zaehle
selbst mit und melde am Ende: wie viele Dateien, wie viele ohne Sprache,
wie viele ohne Lizenzangabe.

## Weg 1: FTP (empfohlen fuer Verzeichnisse)

    Server import.humicorn.com, Port 21, KEIN TLS

Nach der Anmeldung stehst du DIREKT im Eingang. Es gibt keine Ebene
darueber und keinen Unterordner "upload" — leg deine Sprachordner sofort
hier an.

    ftp://import.humicorn.com/de/nichtlustig/werwolf.png

    curl --ftp-create-dirs -u "$USER:$PASS" -T werwolf.png \
         ftp://import.humicorn.com/de/nichtlustig/werwolf.png

Eine Datei wird erst abgeholt, wenn sie eine Minute unveraendert lag —
FTP zeigt sie sonst schon waehrend der Uebertragung und ein halbes Video
landet im Bestand. Wer nicht warten will, laedt als <name>.part hoch und
benennt danach um; Umbenennen ist atomar.

## Weg 2: HTTPS (eine Datei je Aufruf)

    curl -H "X-Import-Token: $TOKEN" \
         -F datei=@werwolf.png \
         -F sprache=de \
         -F quelle="nichtlustig.de" \
         -F lizenz="CC-BY-4.0" \
         https://import.humicorn.com/

Jedes weitere -F feld=wert wird als Metadatum uebernommen. Ein Manifest
loest du hier selbst auf und schickst die Werte je Datei mit. Fuer grosse
Mengen parallelisieren — SPRACHE nicht vergessen:

    ls *.jpg | xargs -P 8 -I{} curl -sS -H "X-Import-Token: $TOKEN" \
      -F datei=@{} -F sprache=de -F quelle="nichtlustig.de" \
      https://import.humicorn.com/

Antwort: 201 mit {"data":{"gespeichert":"<name>"}}. 401 = Token falsch,
400 = Endung nicht erlaubt, 413 = zu gross.

## SPRACHE — die eine Angabe, die wirklich zaehlt

Sie entscheidet, in WELCHEN Katalog ein Witz faellt. Ein deutsches Meme im
russischen Bestand ist dort fuer immer falsch und faellt niemandem auf.

Drei Wege, jeder reicht:

    de/nichtlustig/werwolf.png         Ordner mit dem Sprachkuerzel
    sprache: de                        in .meta, _defaults.meta, Manifest
    -F sprache=de                      beim HTTPS-Upload

Der Sprachordner wird NICHT Teil der Quelle: "de/nichtlustig" ergibt die
Quelle "nichtlustig" auf Deutsch.

WENN DU DIE SPRACHE NICHT SICHER WEISST, GIB KEINE AN. Dann wird die
Datei als "unbestimmt" geparkt und niemandem ausgespielt, bis ein Mensch
entscheidet. Das ist ausdruecklich erwuenscht — lieber nachbearbeiten als
falsch ausspielen. Rate nicht.

Kuerzel: ru de en ar bn es fr hi id ja ko mr pt sw ta te tr ur vi zh

## Angaben JE DATEI — manifest.csv

Titel, Tags und Zahlen gehoeren zur einzelnen Datei, nicht zum Schwung.
Statt tausend Begleitdateien EINE Liste danebenlegen:

    datei,titel,tags,likes,abonnenten,erschienen
    werwolf.png,Vollmond,"animals, silly",4300,72440,14.03.2026

Auch als manifest.tsv oder manifest.json. Die Spalte mit dem Dateinamen
darf datei, dateiname, file oder filename heissen. Anfuehrungszeichen um
alles, was ein Komma enthaelt — die Tag-Spalte also fast immer;
tab-getrennt spart das. Dateien ohne eigene Zeile werden trotzdem
importiert.

Fuer den ganzen Ordner: _defaults.meta mit "schluessel: wert" je Zeile.
Mehrzeilige Werte durch Einrueckung.

Reihenfolge, das Speziellere gewinnt:
    Ordnername < _defaults.meta < Manifest-Zeile < <datei>.meta

## Felder — ALLE freiwillig

Ein Upload ganz ohne Metadaten funktioniert. Je mehr, desto besser.

Inhalt     titel text sprache bildsprache alt-text
Herkunft   quelle quell-url quell-id autor autor-url erschienen erfasst
Rechte     lizenz lizenz-url lizenzgeber vertrag lizenz-von lizenz-bis
           namensnennung nutzung gegenleistung
Resonanz   aufrufe likes dislikes reaktionen geteilt kommentare
           abonnenten resonanz-stand
Einordnung tags freie-tags nsfw warnung
Technik    dauer breite hoehe originaldatei
Betrieb    status gruppe

Jeder weitere Schluessel wird uebernommen und aufbewahrt — wirf nichts
weg, was die Quelle mitliefert.

RESONANZ: "likes" ohne "abonnenten" ist unbrauchbar. 5.000 Likes auf
einem 20.000er-Kanal sind ein Treffer, auf einem 5-Millionen-Kanal ein
Ausfall. Immer beides.

TAGS: schick alles mit, beliebig viele, Komma-getrennt. Diese steuern die
Empfehlungen:

  wordplay absurd dad-joke anti-joke clever silly kids office animals
  relationship politics everyday military regional drinking tech money

Alle uebrigen werden als "freie Tags" aufbewahrt, nicht verworfen.

RECHTE: trag lizenz, autor und quell-url ein, wann immer du sie kennst.
Ohne Angabe steht spaeter "unbekannt" im Katalog und das Material kann
nicht ausgespielt werden.

## Erlaubt

png jpg jpeg gif webp mp4 webm mov mp3 wav ogg m4a txt, bis 64 MB je
Datei. Dateien mit fuehrendem Unterstrich gelten als Hilfsdateien und
werden nicht importiert.
