feat: Vorschau fuer Video und Ton, Ordner anlegen dort, wo man es sucht
Mit den ersten echten Clips fiel auf, was bei 3600 Bildern nie auffiel: alles,
was kein Bild ist, bekam ein FRAGEZEICHEN auf die Kachel -- ausgerechnet das
Zeichen fuer "unbekannt" auf einer voellig gesunden MP4.
Jetzt: ein Standbild aus dem Clip (ein Zehntel hinein, weil viele mit Schwarz
oder einem Einblender beginnen und eine schwarze Kachel so aussagekraeftig ist
wie gar keine), bei Ton das eingebettete Titelbild, dazu ein Abspielzeichen und
die LAUFZEIT in der Ecke. Fehlt eine Vorschau, kommt ein Zeichen, das die ART
benennt, statt eines Fragezeichens.
DER PREIS IST FFMPEG IM ABBILD, und der wurde zweimal gemessen und zweimal
gedrueckt:
vorher 460 MB
apt-get install ffmpeg 1,11 GB
statisches ffmpeg + ffprobe 835 MB
statisches ffmpeg allein 648 MB
Debians Paket schaltet jeden Filter frei und zieht die Abhaengigkeiten mit:
libllvm15 (114 MB), Mesa samt libgl1-mesa-dri, libz3 und libflite1 -- ein
SPRACHSYNTHESIZER. Alles fuer Filter, die ein Dienst ohne Bildschirm nie
anfasst; --no-install-recommends half nicht, es sind harte Abhaengigkeiten.
ffprobe flog danach auch noch raus: 135 MB fuer eine einzige Aufgabe, die
Laenge zu nennen -- die steht auch im Kopf, den ffmpeg beim Oeffnen druckt.
Gegengeprueft an beiden Dateien, auf zwei Nachkommastellen identisch:
ffprobe 29.767967 | ffmpeg Duration: 00:00:29.77
ffprobe 645.642449 | ffmpeg Duration: 00:10:45.64
Der Preis dafuer ist ebenfalls zu benennen: die Fassung haengt jetzt an einer
Zeile im Dockerfile und nicht mehr an apt. Vertretbar, weil ffmpeg hier nur
eigene, bereits abgelegte Dateien anfasst und nicht am Netz haengt.
EIN FEHLER, DER ZWEIMAL DERSELBE WAR. "Keine Bildspur" ist bei Ton der
Normalfall -- die meisten MP3 tragen kein Titelbild. Der erste Anlauf erkannte
das am WORTLAUT der Fehlermeldung, und der ist zwischen den Fassungen anders:
ffmpeg 5.1 "Stream map '0:v:0' matches no streams."
ffmpeg 7.1 "Failed to set value '0:v:0' for option 'map'"
Ergebnis: eine gesunde MP3 wurde als "1 fehlgeschlagen" gezaehlt, und dann
sucht jemand einen Fehler, den es nicht gibt. Gelesen wird jetzt die
SPURENLISTE ("Stream #0:1: Video:"), die seit jeher so dasteht -- und die kommt
aus demselben Aufruf wie die Laenge, also ein Blick in die Datei statt drei.
Gemessen: fehler 0, ohneBild 1.
Beide Wege durchgeprueft. Video: 320x180, Durchschnittsfarbe RGB(97,140,155) --
echtes Bild und kein schwarzer Vorspann. Ton mit angehaengtem Titelbild:
Vorschau erzeugt, dauer 8.05, Kachel zeigt 0:08.
UND ZWEI ORDNER-LUECKEN, beide beim Benutzen gefunden.
"Wie lege ich neue Ordner an?" -- gar nicht, ausser man wusste es: der Knopf
sass NUR im Verschieben-Dialog. Wer einen leeren Ordner wollte, musste erst
Dateien auswaehlen und "Verschieben" druecken. Eine Funktion, die man nur ueber
eine andere Funktion erreicht, ist fuer den, der sie sucht, nicht vorhanden.
Jetzt steht sie unter dem Ordnerbaum, mit der Angabe, IN welchem Ordner sie
entsteht -- sonst tippt jemand "waffen", landet in "items/waffen" und sucht
danach an der Wurzel.
Zielordner beim Hochladen: vorher galt stillschweigend der in der Galerie
angeklickte. Richtig, solange man es weiss, und ein Fallstrick, sobald man es
nicht weiss -- wer nach einer Suche hochlaedt, steht in "Alle" und legt an der
Wurzel ab. Der angeklickte bleibt die Voreinstellung, ist jetzt aber sichtbar
und aenderbar, samt "neuer Ordner" direkt daneben.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 5
@@ -10,6 +10,7 @@
|
||||
// unter einem anderen Namen als dem, den der Aufrufer erwartet, und niemand
|
||||
// merkt es, bis das Bild fehlt.
|
||||
|
||||
import { execFile } from 'node:child_process'
|
||||
import { createHash } from 'node:crypto'
|
||||
import { mkdir, rename, rm, stat, writeFile } from 'node:fs/promises'
|
||||
import { dirname, join, resolve, sep } from 'node:path'
|
||||
@@ -243,6 +244,174 @@ export async function writeThumb(path: string, data: Buffer): Promise<boolean> {
|
||||
}
|
||||
}
|
||||
|
||||
// ------------------------------------------- Vorschau fuer Video und Ton
|
||||
//
|
||||
// Bis hierhin bekam alles, was kein Bild ist, ein Fragezeichen auf die Kachel.
|
||||
// Bei 3600 Bildern faellt das nicht auf; bei einer Handvoll Clips ist die
|
||||
// Galerie dann eine Liste von Dateinamen.
|
||||
//
|
||||
// VIDEO: ein Standbild. sharp kann das nicht -- libvips dekodiert kein Video.
|
||||
// Also ffmpeg, und zwar auf die Datei AUF DER PLATTE und nicht auf den Puffer:
|
||||
// ein Container wie MP4 hat seine Inhaltsangabe je nach Kodierer am Ende, und
|
||||
// ohne Springen findet ffmpeg sie nicht.
|
||||
//
|
||||
// TON: das eingebettete Titelbild, wenn eines da ist. Fuer ffmpeg ist das
|
||||
// schlicht die Videospur der Datei -- derselbe Aufruf, andere Zeitmarke.
|
||||
// Ist keines da, entsteht keine Vorschau, und die Kachel zeigt ein Notenzeichen
|
||||
// statt eines leeren Rahmens.
|
||||
|
||||
export const kannBewegtVorschau = (mime: string) =>
|
||||
/^(video|audio)\//.test(mime.split(';')[0]?.trim().toLowerCase() ?? '')
|
||||
|
||||
/** Wie lange wir ffmpeg zugestehen.
|
||||
*
|
||||
* Ein beschaedigter Container kann einen Dekodierer beliebig lange
|
||||
* beschaeftigen. 20 Sekunden reichen fuer ein Standbild aus jeder gesunden
|
||||
* Datei -- was laenger braucht, bekommt eben keine Vorschau. */
|
||||
const FFMPEG_MS = 20_000
|
||||
|
||||
/** Was in der Datei steckt: wie lang, und ob es ueberhaupt ein Bild gibt.
|
||||
*
|
||||
* BEIDES AUS EINEM AUFRUF. `ffmpeg -i datei` ohne Ausgabeziel bricht mit einem
|
||||
* Fehler ab ("At least one output file must be specified") -- seinen Kopf hat
|
||||
* es da aber laengst gedruckt, und darin steht alles, was wir brauchen. Der
|
||||
* Rueckgabewert wird deshalb bewusst ignoriert und nur stderr gelesen. Kein
|
||||
* `-f null -`: das dekodierte die ganze Datei, um am Ende dasselbe zu wissen.
|
||||
*
|
||||
* OHNE ffprobe, und das ist eine gemessene Entscheidung: das Werkzeug haette
|
||||
* als statische Binaerdatei 135 MB ins Abbild gebracht. Gegengeprueft an
|
||||
* beiden Dateien, die hier liegen, auf zwei Nachkommastellen identisch:
|
||||
*
|
||||
* ffprobe 29.767967 | ffmpeg Duration: 00:00:29.77
|
||||
* ffprobe 645.642449 | ffmpeg Duration: 00:10:45.64
|
||||
*
|
||||
* Fuer eine Beschriftung wie "0:29" ist das genauer als noetig.
|
||||
*
|
||||
* `hatBild` WIRD AUS DER SPURENLISTE GELESEN und nicht aus einer
|
||||
* Fehlermeldung. Genau daran ist der erste Anlauf gescheitert: er erkannte
|
||||
* "keine Bildspur" am Wortlaut, und der ist zwischen den Fassungen anders --
|
||||
*
|
||||
* ffmpeg 5.1 "Stream map '0:v:0' matches no streams."
|
||||
* ffmpeg 7.1 "Failed to set value '0:v:0' for option 'map'"
|
||||
*
|
||||
* -- worauf eine voellig gesunde MP3 als "1 fehlgeschlagen" gezaehlt wurde.
|
||||
* Die Zeile "Stream #0:1: Video:" dagegen steht seit jeher so da. */
|
||||
export type MedienInfo = { dauer: number | null; hatBild: boolean }
|
||||
|
||||
export async function medienInfo(path: string): Promise<MedienInfo> {
|
||||
const { stderr } = await ffmpegRoh(['-i', absolutePath(path)])
|
||||
|
||||
// "Duration: 00:10:45.64," -- bei Stroemen ohne Laengenangabe "Duration: N/A".
|
||||
const treffer = /Duration:\s*(\d+):(\d\d):(\d\d(?:\.\d+)?)/.exec(stderr)
|
||||
const sekunden = treffer
|
||||
? Number(treffer[1]) * 3600 + Number(treffer[2]) * 60 + Number(treffer[3])
|
||||
: NaN
|
||||
|
||||
return {
|
||||
dauer: Number.isFinite(sekunden) && sekunden > 0 ? sekunden : null,
|
||||
// Ein eingebettetes Titelbild ist fuer ffmpeg eine Bildspur:
|
||||
// "Stream #0:1: Video: mjpeg ... (attached pic)".
|
||||
hatBild: /Stream #\d+:\d+[^\n]*:\s*Video:/.test(stderr),
|
||||
}
|
||||
}
|
||||
|
||||
/** Was bei einem Versuch herauskam.
|
||||
*
|
||||
* DREI Zustaende und nicht zwei, und das ist nachgemessen: eine MP3 OHNE
|
||||
* eingebettetes Titelbild ist voellig in Ordnung -- sie hat schlicht keine
|
||||
* Bildspur. Mit einem blossen true/false zaehlte der Nachzieh-Knopf sie als
|
||||
* "1 fehlgeschlagen", und dann sucht jemand einen Fehler, den es nicht gibt.
|
||||
* Genau so ist es beim ersten Lauf passiert. */
|
||||
export type BewegtErgebnis = 'ok' | 'keinBild' | 'fehler'
|
||||
|
||||
/** Ein Standbild bzw. Titelbild als Vorschau, samt Laenge.
|
||||
*
|
||||
* Gibt BEIDES zurueck, weil beides aus demselben Blick in die Datei kommt: ein
|
||||
* zweiter Aufruf nur fuer die Sekundenzahl waere die doppelte Arbeit.
|
||||
*
|
||||
* Wie writeThumb: ein Fehlschlag ist KEIN Grund, den Upload scheitern zu
|
||||
* lassen. */
|
||||
export async function writeBewegtThumb(
|
||||
path: string,
|
||||
mime: string,
|
||||
): Promise<{ ergebnis: BewegtErgebnis; dauer: number | null }> {
|
||||
const ziel = thumbPath(path)
|
||||
const quelle = absolutePath(path)
|
||||
const istVideo = mime.startsWith('video')
|
||||
|
||||
const info = await medienInfo(path)
|
||||
|
||||
// Keine Bildspur: bei Ton der Normalfall (die meisten MP3 tragen kein
|
||||
// Titelbild). Hier wird ffmpeg gar nicht erst ein zweites Mal bemueht.
|
||||
if (!info.hatBild) return { ergebnis: 'keinBild', dauer: info.dauer }
|
||||
|
||||
try {
|
||||
await mkdir(dirname(ziel), { recursive: true })
|
||||
|
||||
// Bei Video NICHT den Anfang nehmen, wenn sich das vermeiden laesst:
|
||||
// viele Clips beginnen mit Schwarz oder einem Einblender, und eine
|
||||
// schwarze Kachel ist so aussagekraeftig wie gar keine. Ein Zehntel
|
||||
// hinein ist fast immer Bild.
|
||||
//
|
||||
// Bei Ton NICHT springen: das eingebettete Titelbild ist ein einzelnes
|
||||
// Standbild, und ein -ss darauf findet nichts mehr.
|
||||
const start = istVideo && info.dauer ? Math.min(info.dauer * 0.1, 10) : 0
|
||||
|
||||
const temp = `${ziel}.${process.pid}.tmp.webp`
|
||||
await ffmpeg([
|
||||
// -ss VOR -i: dann springt ffmpeg, statt bis dorthin zu dekodieren.
|
||||
...(start > 0 ? ['-ss', start.toFixed(2)] : []),
|
||||
'-i', quelle,
|
||||
// Nur die Bildspur, genau ein Bild. Bei einer MP3 ist das
|
||||
// eingebettete Titelbild genau diese Spur.
|
||||
'-map', '0:v:0',
|
||||
'-frames:v', '1',
|
||||
// Nicht aufblasen: ein 64 Pixel breites Titelbild bleibt klein.
|
||||
'-vf', `scale='min(${THUMB_BREITE},iw)':-2`,
|
||||
'-f', 'webp',
|
||||
'-y', temp,
|
||||
])
|
||||
|
||||
await rename(temp, ziel)
|
||||
return { ergebnis: 'ok', dauer: info.dauer }
|
||||
} catch (err) {
|
||||
console.error(`[thumbs] ${path}: ${err instanceof Error ? err.message : err}`)
|
||||
return { ergebnis: 'fehler', dauer: info.dauer }
|
||||
}
|
||||
}
|
||||
|
||||
/** ffmpeg aufrufen, OHNE zu urteilen: gibt zurueck, was herauskam, samt
|
||||
* Rueckgabewert. Fuer den Fall, dass ein Fehlschlag die Antwort IST -- siehe
|
||||
* medienDauer.
|
||||
*
|
||||
* execFile und NICHT exec: ohne Shell dazwischen gibt es keine Zeichenkette,
|
||||
* in der ein Dateiname etwas anderes bedeuten koennte. Der Pfad ist zwar durch
|
||||
* checkPath gegangen, aber diese Abwehr kostet nichts. */
|
||||
function ffmpegRoh(args: string[]): Promise<{ code: number | null; stderr: string }> {
|
||||
return new Promise((erfuellen) => {
|
||||
execFile(
|
||||
'ffmpeg',
|
||||
args,
|
||||
{ timeout: FFMPEG_MS, maxBuffer: 4 * 1024 * 1024 },
|
||||
(fehler, _stdout, stderr) => {
|
||||
erfuellen({
|
||||
code: fehler ? ((fehler as { code?: number }).code ?? 1) : 0,
|
||||
stderr,
|
||||
})
|
||||
},
|
||||
)
|
||||
})
|
||||
}
|
||||
|
||||
/** Dasselbe, aber ein Fehlschlag ist ein Fehlschlag. */
|
||||
async function ffmpeg(args: string[]): Promise<void> {
|
||||
const { code, stderr } = await ffmpegRoh(args)
|
||||
if (code !== 0) {
|
||||
// Die letzte Zeile von ffmpeg ist die, die den Grund nennt.
|
||||
throw new Error(stderr.trim().split('\n').pop() ?? `ffmpeg endete mit ${code}`)
|
||||
}
|
||||
}
|
||||
|
||||
/** Eine Datei samt Vorschau an einen anderen Pfad legen.
|
||||
*
|
||||
* DER PFAD IST DER SCHLUESSEL — deshalb ist Verschieben hier kein Kopieren
|
||||
|
||||
Reference in New Issue
Block a user