quietshrink — Agent-Fähigkeit
Sie haben Zugriff auf cli-anything-quietshrink, ein CLI zum Komprimieren von Videodateien auf macOS Apple Silicon. Es nutzt die Media Engine (Hardware-HEVC-Encoder), nicht die CPU, sodass die Kodierung schnell und leise erfolgt.
Wann verwenden
- Benutzer möchte eine Bildschirmaufnahme, einen Screencast oder eine beliebige .mov/.mp4-Datei komprimieren
- Datei ist zu groß zum Teilen (Chat, E-Mail, GitHub)
- Kleinere Dateien nötig, aber kein sichtbarer Qualitätsverlust akzeptabel
- Apple Silicon Mac (M1/M2/M3/M4) — beste Ergebnisse
Nicht verwenden für Nicht-Bildschirminhalte (Kameraaufnahmen, Vlogs) – die Einsparungen sind viel geringer, da keine doppelten Frames zum Entfernen vorhanden sind.
Befehle
# Komprimieren mit standardmäßig transparenter Qualität
cli-anything-quietshrink compress <eingabe> [ausgabe]
# Komprimieren mit bestimmter Voreinstellung
cli-anything-quietshrink compress -q tiny <eingabe> # kleinste
cli-anything-quietshrink compress -q transparent <eingabe> # Standard, visuell verlustfrei
cli-anything-quietshrink compress -q pristine <eingabe> # nahezu Quellqualität
# Datei vor der Komprimierung inspizieren
cli-anything-quietshrink probe <eingabe>
# Qualitätsvoreinstellungen auflisten
cli-anything-quietshrink presets
# Umgebung überprüfen
cli-anything-quietshrink doctor
Alle Befehle akzeptieren --json für maschinenlesbare Ausgabe.
Qualitätsvoreinstellungen
| Voreinstellung | q | Typische Reduzierung | SSIM | Anwendungsfall |
|---|---|---|---|---|
tiny | 50 | ~90% | ~0.95 | Chat/E-Mail — kleine Artefakte in Ordnung |
balanced | 55 | ~88% | ~0.99 | Dokumente/Teilen — hohe Qualität |
transparent (Standard) | 60 | ~87% | ~0.99+ | Alles Wichtige — visuell verlustfrei |
pristine | 70 | ~84% | ~0.997 | Archivierung — nahezu Quelle |
JSON-Ausgabeschema
compress gibt zurück:
{
"input": "/Pfad/zur/eingabe.mov",
"output": "/Pfad/zur/ausgabe.mov",
"input_size": 105952129,
"output_size": 12345678,
"saved_bytes": 93606451,
"saved_percent": 88.3,
"duration_seconds": 193.3,
"elapsed_seconds": 87,
"encoding_speed": "2.2x",
"quality_preset": "transparent",
"q_value": 60,
"gop": 600
}
probe gibt zurück:
{
"path": "...",
"size_bytes": 105952129,
"size_mb": 101.04,
"codec": "h264",
"width": 3024,
"height": 1964,
"framerate": "120/1",
"duration_seconds": 193.31
}
Entscheidungsablauf für Agenten
Benutzer möchte eine Aufnahme teilen
├─ Läuft auf Apple Silicon Mac? → quietshrink verwenden
│ ├─ Für Chat/E-Mail/schnelles Teilen → -q tiny
│ ├─ Für Dokumente/wichtiges Teilen → -q transparent (Standard)
│ └─ Für Archivierung/Bearbeitung → -q pristine
└─ Nicht auf Mac? → Fallback auf Software, weniger effizient
Vor der Verarbeitung doctor ausführen, um die Umgebung zu überprüfen.
Bei unbekannten Dateien probe ausführen, um Auflösung/Codec/Dauer zu verstehen.
Fehler und Behebung
ffmpeg nicht gefunden→brew install ffmpeghevc_videotoolbox nicht verfügbar→brew reinstall ffmpegcompression_failed→ Prüfen, ob Eingabedatei beschädigt ist;--verbose-Modus versuchen, um ffmpeg-Fehler zu sehen
Quelle
- Haupt-Repository: https://github.com/achiya-automation/quietshrink
- Bash-CLI: Befehl
quietshrink(über das Installationsskript) - Warum dieser Ansatz funktioniert: siehe WHY.md