Schneller, schlanker Bildbetrachter mit Bildbearbeitung, Texterkennung und KI-Schnittstelle.
KiekAn! ist ein schneller Bildbetrachter für Linux, inspiriert von IrfanView. Er öffnet Bilder ohne Wartezeit, blättert flüssig durch große Ordner und beherrscht neben den gängigen Formaten auch HEIC, AVIF, Kamera-RAW, JPEG 2000, PSD, DjVu, PDF und Videos. Für den Alltag bringt er die wichtigen Werkzeuge mit: Zuschneiden, Drehen, Farben, Gradationskurven, Schärfen, Effekte, Texterkennung mit automatischer Sprachwahl und das Teilen großer PDFs. Über eine eingebaute MCP-Schnittstelle können KI-Assistenten wie Claude mit Bildern und Dokumenten arbeiten.
„KiekAn!“ kommt vom plattdeutschen „Kiek an!“ – „Guck mal an!“.
English: KiekAn! is a fast, lightweight image viewer for Linux, inspired by IrfanView, with editing, OCR with automatic language detection, PDF splitting and an MCP interface for AI assistants such as Claude. The user interface is available in German and English.
| Gradationskurven mit Live-Vorschau | Texterkennung | EXIF-Daten |
|---|---|---|
![]() |
![]() |
![]() |
Fertige Pakete liegen unter Releases. Weil sich die Bibliotheksversionen der Distributionen unterscheiden, gibt es je System ein eigenes Paket:
| System | Paket | Installieren |
|---|---|---|
| Ubuntu 24.04, Linux Mint 22, Pop!_OS 24.04 | kiekan_<version>_ubuntu24.04_<arch>.deb |
sudo apt install ./kiekan_…deb |
| Ubuntu 22.04, Linux Mint 21, Pop!_OS 22.04 | kiekan_<version>_ubuntu22.04_<arch>.deb |
sudo apt install ./kiekan_…deb |
| Debian 13 / 12, Raspberry Pi OS (64 Bit) | kiekan_<version>_debian13_<arch>.deb / …_debian12_… |
sudo apt install ./kiekan_…deb |
| Fedora 44 / 43 | kiekan-<version>-1.fc44.<arch>.rpm / ….fc43… |
sudo dnf install ./kiekan-…rpm |
| openSUSE Tumbleweed / Leap 16 | kiekan-<version>-1.opensuse.<arch>.rpm / ….leap16… |
sudo zypper install ./kiekan-…rpm |
| Arch Linux, Manjaro | packaging/arch/PKGBUILD |
makepkg -si |
| Gentoo | packaging/gentoo (Ebuild) |
in ein lokales Overlay kopieren |
| NixOS, Nix | packaging/nix |
nix-build packaging/nix |
| macOS 13+ (Apple Silicon) | KiekAn-<version>-macos-arm64.dmg |
siehe unten |
| alle anderen (Flatpak) | packaging/flatpak |
siehe unten |
<arch> ist amd64/x86_64 für übliche PCs und arm64/aarch64 für ARM-Rechner
wie den Raspberry Pi 4/5 oder ARM-Laptops.
Die Befehle laden jeweils die neueste Version für das eigene System und den eigenen Prozessor herunter und installieren sie. Für ein Update einfach erneut ausführen.
Ubuntu 24.04, Linux Mint 22, Pop!_OS 24.04:
wget -qO- https://api.github.com/repos/Codatus/kiekan/releases/latest | grep -o "https://[^\"]*_ubuntu24\.04_$(dpkg --print-architecture)\.deb" | wget -qi - -O /tmp/kiekan.deb && sudo apt install /tmp/kiekan.debUbuntu 22.04, Linux Mint 21, Pop!_OS 22.04:
wget -qO- https://api.github.com/repos/Codatus/kiekan/releases/latest | grep -o "https://[^\"]*_ubuntu22\.04_$(dpkg --print-architecture)\.deb" | wget -qi - -O /tmp/kiekan.deb && sudo apt install /tmp/kiekan.debDebian 13 (für Debian 12 debian13 durch debian12 ersetzen), Raspberry Pi OS:
wget -qO- https://api.github.com/repos/Codatus/kiekan/releases/latest | grep -o "https://[^\"]*_debian13_$(dpkg --print-architecture)\.deb" | wget -qi - -O /tmp/kiekan.deb && sudo apt install /tmp/kiekan.debFedora 43/44:
sudo dnf install "$(curl -s https://api.github.com/repos/Codatus/kiekan/releases/latest | grep -o "https://[^\"]*\.fc$(rpm -E %fedora)\.$(uname -m)\.rpm")"openSUSE Tumbleweed (für Leap 16 opensuse durch leap16 ersetzen):
sudo zypper install "$(curl -s https://api.github.com/repos/Codatus/kiekan/releases/latest | grep -o "https://[^\"]*\.opensuse\.$(uname -m)\.rpm")"Arch Linux, Manjaro:
git clone --depth 1 https://github.com/Codatus/kiekan /tmp/kiekan && cd /tmp/kiekan/packaging/arch && makepkg -simacOS (Apple Silicon), danach das Programm in den Programme-Ordner ziehen:
curl -L -o /tmp/KiekAn.dmg "$(curl -s https://api.github.com/repos/Codatus/kiekan/releases/latest | grep -o 'https://[^"]*\.dmg')" && open /tmp/KiekAn.dmgWayland: KiekAn! läuft unter X11 und unter Wayland (GNOME, KDE Plasma,
LXQt mit labwc …). Für die direkte Wayland-Darstellung braucht Qt sein
Wayland-Modul (qt6-wayland); die Pakete schlagen es zur Installation vor.
Fehlt es, läuft KiekAn! über XWayland.
macOS: Das Programm ist nicht bei Apple beglaubigt (dafür wäre ein kostenpflichtiges Entwicklerkonto nötig). Beim ersten Start meldet macOS deshalb einen „nicht verifizierten Entwickler“: KiekAn! in den Programme-Ordner ziehen, dann Rechtsklick → „Öffnen“ → „Öffnen“ bestätigen. Danach startet es normal.
HEIC-Fotos (iPhone) brauchen einen HEVC-Decoder, den Fedora und openSUSE aus
Patentgründen nicht mitliefern: unter Fedora libheif-freeworld aus
RPM Fusion, unter openSUSE die Codecs aus Packman.
Das Flatpak bringt alles selbst mit.
Flatpak (bis zur Aufnahme in Flathub selbst bauen):
flatpak-builder --user --install --install-deps-from=flathub --force-clean build-flatpak packaging/flatpak/io.github.codatus.kiekan.yml
flatpak run io.github.codatus.kiekanFür Windows 10/11 gibt es ein portables ZIP (KiekAn-<version>-windows-x64.zip):
entpacken und kiekan.exe starten – ohne Installation. Es enthält alle
Bibliotheken und die Tesseract-Sprachdaten für Deutsch, Englisch und Fraktur.
In KiekAn!: Einstellungen (Taste P) → Reiter „Dateizuordnung“. Dort
ankreuzen, welche Dateitypen KiekAn! öffnen soll, und „Zuordnung übernehmen“
klicken. Vorausgewählt sind Bilder und Kamera-RAW; PDF-Dokumente und Videos
sind nicht angekreuzt und bleiben bei ihren bisherigen Programmen, solange
Sie sie nicht ausdrücklich wählen. Ein entfernter Haken gibt den Dateityp an
die Vorgabe des Systems zurück. Geändert wird nur Ihre eigene
~/.config/mimeapps.list (bei LXQt, KDE usw. zusätzlich eine vorhandene
<desktop>-mimeapps.list).
Unter „Erweiterte Einstellungen …“ lässt sich jeder Dateityp einzeln festlegen, etwa nur HEIC und JPEG, aber nicht PNG. Jede Zeile nennt die Dateiendungen und das Programm, das den Typ derzeit öffnet; ein Suchfeld hilft beim Finden. Ist eine Gruppe nur teilweise gewählt, zeigt der Reiter das mit einem halben Haken, und „Zuordnung übernehmen“ lässt diese Gruppe unverändert.
Von Hand: Im Dateimanager Rechtsklick auf ein Bild → „Öffnen mit“ → KiekAn! wählen und „als Standard“ bzw. „immer verwenden“ ankreuzen – das gilt für diesen einen Dateityp. Im Terminal für mehrere Typen auf einmal:
xdg-mime default kiekan.desktop image/jpeg image/png image/gif image/webp image/tiff image/heic image/avifBeim Flatpak heißt die Desktop-Datei io.github.codatus.kiekan.desktop.
Windows: Rechtsklick auf ein Bild → „Öffnen mit“ → „Andere App auswählen“
→ kiekan.exe suchen und „Immer diese App verwenden“ ankreuzen. Windows lässt
Programme diese Einstellung nicht selbst ändern; der Reiter „Dateizuordnung“
öffnet deshalb nur die Windows-Einstellungen „Standard-Apps“.
-
Bilder sofort anzeigen, Ordner per Tastatur oder Mausrad durchblättern
-
Vorladen der Nachbarbilder im Hintergrund, damit das Blättern ohne Wartezeit läuft
-
Im Vollbild oben links klein in Grün Pfad, Dateiname und Position im Ordner (wie in IrfanView; abschaltbar in den Einstellungen)
-
Auf Wunsch über Ordnergrenzen blättern: Nach dem letzten Bild geht es im nächsten Ordner weiter, vor dem ersten im vorigen – sortiert wie im Dateimanager (Unterordner vor Dateien), leere Ordner werden übersprungen, auch über höhere Ordner hinweg. Ein Hinweis im Bild (und beim Bildschirmleser die Ansage „Neuer Ordner …“) zeigt jeden Wechsel. Im persönlichen Ordner bleibt die Suche in dessen Unterordner (z. B. „Bilder“). Beim ersten Mal am Ordnerende fragt KiekAn!; änderbar unter Extras → Einstellungen → „Am Ende eines Ordners“
-
Zoom, Originalgröße, An-Fenster-Anpassen, Vollbild
-
Drehen, Spiegeln, Zuschneiden, Größe ändern, Rückgängig
-
JPEGs werden verlustfrei gedreht und gespiegelt: Beim Speichern ordnet KiekAn! die komprimierten Bildblöcke um (libjpeg-turbo), statt neu zu kodieren; passen die Maße nicht dazu, ändert es nur die EXIF-Ausrichtung
-
Text markieren (Knopf in der Werkzeugleiste oder Taste T): erkennt den Text im Bild (der Fortschritt läuft als Kreis im Knopf), richtet quer oder kopfstehend gescannte Seiten dabei auf und macht den Text markierbar – ziehen markiert, Doppelklick markiert ein Wort, Strg+A alles, Strg+C kopiert. Beim Weiterblättern fragt KiekAn!, ob Text und Drehung in der Datei gespeichert werden sollen (bei JPEG verlustfrei, der Text in den XMP-Metadaten); dann ist der Text beim nächsten Öffnen sofort markierbar. Die Antwort lässt sich merken und in den Einstellungen ändern. Liest die Erkennung nicht alles, liest Strg+T neu und gründlicher (vergrößert, zusätzlich hell auf dunkel). Hellen Text auf dunklem Grund, etwa auf Buchumschlägen, erkennt KiekAn! auch ohne Strg+T
-
Dokumente automatisch aufrichten (Einstellungen, standardmäßig aus): Quer oder kopfstehend fotografierte Seiten erkennt KiekAn! im Hintergrund am Text und zeigt sie richtig herum, auch wenn die EXIF-Angabe etwas anderes sagt. Fotos bleiben unberührt. Die Drehung gilt zunächst nur für die Anzeige: Strg+S speichert sie (bei JPEG verlustfrei), Strg+Z nimmt sie zurück, und beim Weiterblättern fragt KiekAn! deswegen nicht nach
-
Text im ganzen Ordner erkennen (Datei-Menü): erkennt den Text aller Bilder des Ordners und speichert ihn in den Dateien – danach ist er beim Blättern sofort markierbar und vorlesbar
-
Bildschirmleser (Orca, NVDA, VoiceOver), siehe unten
-
Zuerst Betrachter: Wer ein Bild dreht oder bearbeitet und dann weiterblättert, verwirft die Änderung ohne Rückfrage – gespeichert wird nur mit Strg+S. Die Nachfrage „Änderungen speichern?“ lässt sich in den Einstellungen einschalten (ein eingefügtes Bild aus der Zwischenablage fragt immer nach)
-
Stapelverarbeitung (Taste B): viele Bilder umwandeln (Format, Qualität, Verkleinern, Farbkorrektur, Graustufen, Metadaten) und umbenennen nach Muster mit Vorschau, Konfliktprüfung und Rücknahme
-
Diashow (Taste W) mit einstellbarer Anzeigedauer, Pause mit der Leertaste
-
Drucken (Strg+P) mit Druckvorschau, an die Seite angepasst
-
Tastenkürzel frei belegen (Extras → Tastenkürzel anpassen)
-
Bilder aus der Zwischenablage einfügen und als Datei speichern
-
Speichern als PNG, JPEG, WebP, BMP, TIFF, AVIF, HEIC und PDF:
- PDF mit unsichtbarem Text, wenn er erkannt ist (T): die PDF ist dann durchsuchbar und der Text kopierbar. In der Stapelverarbeitung auch alle Bilder in eine PDF (z. B. fotografierte Briefseiten), auf Wunsch mit Texterkennung für Bilder ohne gespeicherten Text
- AVIF/HEIC (deutlich kleiner als JPEG), sofern libheif einen Encoder hat (unter Debian/Ubuntu ab 24.04 die Pakete libheif-plugin-aomenc bzw. libheif-plugin-x265); EXIF und XMP werden übernommen
- 16 Bit je Farbkanal bleiben bei PNG und TIFF erhalten, wenn das Bild nur gedreht oder gespiegelt wurde
-
Umbenennen, in den Papierkorb verschieben, Bildinformationen
-
Histogramm (RGB, Helligkeit, logarithmisch, Kennwerte)
-
Gradationskurven mit Histogramm im Hintergrund, Histogrammausgleich als bearbeitbare Kurve, Auto-Tonwert
-
Graustufen, Schwarzweiß (mit Rasterung), Negativ, automatische Farbkorrektur
-
Farben anpassen: Helligkeit, Kontrast, Gamma, Sättigung, Farbton, Rot/Grün/Blau
-
Schärfen (Unscharf maskieren), Weichzeichnen
-
Effekte: Sepia, Relief, Kanten, Posterisieren, Verpixeln, Vignette, Rauschen
-
Alle Korrekturen mit Live-Vorschau; mit Auswahl wirken sie nur auf den markierten Bereich
-
Filter-Plugins (siehe unten)
-
Deutsch und Englisch, automatisches Drehen nach EXIF abschaltbar
-
Videos (über libmpv) mit Bedienleiste; im Vollbild erscheint sie bei Mausbewegung über dem Bild (Zeitleiste mit Zielzeit beim Überfahren, Klick springt dorthin); Einzelbilder kopieren und speichern
-
PDF-Seiten (über QtPdf) und mehrseitige TIFFs seitenweise blättern
-
Animierte GIF/WebP werden abgespielt
-
EXIF/IPTC/XMP anzeigen (mit Suche und Kartenlink bei GPS); beim Speichern bleiben die Metadaten erhalten
-
Texterkennung (OCR-Fenster, Strg+Umschalt+T) mit automatischer Wahl des Sprachpakets und Aufrichten gedrehter Seiten; PDFs mit Textebene werden direkt gelesen
-
Texterkennung läuft wie bei ocrmypdf in einfädigen Tesseract-Hilfsprozessen, mehrere Seiten parallel (Anzahl in den Einstellungen)
-
PDFs teilen (Datei → PDF teilen) nach Größe, Seitenzahl oder Bereichen, bevorzugt an Lesezeichen; Teile zeigen die Originalseitenzahlen, Teilungsprotokoll als JSON und Markdown; beim Ansehen eines Teils nennt die Statuszeile die Originalseite
-
Zusätzliche Bildformate als eigene Plugins: PSD/PSB, HEIC/HEIF, AVIF, Kamera-RAW (CR2, CR3, NEF, ARW, RAF, RW2, DNG, ORF, PEF …), JPEG 2000, DjVu (mehrseitig)
-
Kamera-RAW: beim Blättern die eingebettete Vorschau (Sekundenbruchteile), volle Entwicklung im Hintergrund beim Hineinzoomen oder mit Strg+D; Bearbeiten und Konvertieren über die KI-Schnittstelle entwickeln immer voll
-
EXIF auch dort, wo exiv2 das Format nicht kennt: HEIC/AVIF (EXIF-Block über libheif) und z. B. Canon CR3 (Aufnahmedaten über LibRaw)
-
Titel, Beschreibung, Stichwörter und Bewertung anzeigen (Bildinformationen)
-
Bildbeschreibung (Alternativtext für Bildschirmleser, Taste D) schreiben und ändern; gespeichert im IPTC-Feld „Alt Text (Accessibility)“, das auch andere Programme lesen
-
Schnittstelle für KI-Assistenten (MCP), siehe unten
| Taste | Funktion |
|---|---|
| Leertaste, Bild ab, → | Nächstes Bild |
| Rücktaste, Bild auf, ← | Vorheriges Bild |
| Pos1 / Ende | Erstes / letztes Bild |
| Mausrad | Blättern |
| Strg + Mausrad, + / − | Zoomen |
| Strg+H | Originalgröße (100 %) |
| F | An Fenster anpassen |
| Eingabe, F11, Doppelklick | Vollbild |
| Esc | Vollbild beenden / Auswahl aufheben / Beenden |
| Linke Maustaste ziehen | Bereich auswählen |
| Rechte Maustaste ziehen | Verschieben (wenn gezoomt) |
| Strg+Y | Auf Auswahl zuschneiden |
| Strg+C / Strg+V | Kopieren / Einfügen |
| Strg+N | Neues leeres Fenster – z. B. Bereich markieren, Strg+C, Strg+N, Strg+V |
| R / L | Rechts / links drehen |
| H / V | Horizontal / vertikal spiegeln |
| Strg+R | Größe ändern |
| Strg+Z | Rückgängig |
| Strg+G | Graustufen |
| Strg+Umschalt+B | Schwarzweiß |
| Strg+Umschalt+N | Negativ |
| Umschalt+U | Automatische Farbkorrektur |
| Strg+Umschalt+E | Histogramm ausgleichen |
| Umschalt+G | Farben anpassen |
| Strg+M | Gradationskurven |
| Umschalt+S | Schärfen |
| Strg+E | Effekte-Browser |
| Umschalt+H | Histogramm anzeigen |
| P | Einstellungen |
| O | Öffnen |
| Strg+S / S | Speichern / Speichern unter |
| B | Stapelverarbeitung (Umwandeln, Umbenennen) |
| W | Diashow (Leertaste: Pause, Esc: Ende) |
| Strg+P | |
| F2 | Umbenennen |
| Entf | In den Papierkorb |
| I | Bildinformationen |
| T | Text markieren (erkennt den Text im Bild) |
| Strg+T | Text neu und gründlich erkennen |
| Strg+Umschalt+T | Text erkennen (OCR-Fenster), mit Auswahl nur im markierten Bereich |
| D | Bildbeschreibung (Alternativtext) |
| Umschalt+Pfeile, Umschalt+Pos1/Ende (Textmodus) | Text markieren |
| Strg+D | Kamera-RAW voll entwickeln |
| E | EXIF-Daten |
| Strg+Bild ab / Strg+Bild auf | Nächste / vorherige Seite (PDF, TIFF) |
| Leertaste (Video) | Abspielen / Pause |
| Pfeiltaste gedrückt halten | zügig blättern (jedes Bild bleibt kurz sichtbar) |
| 1 … 9, 0 (auch Ziffernblock) | 1 … 9 bzw. 10 Dateien vor; mit Strg zurück |
| → / ← (Video) | 5 s vor / zurück, mit Umschalt 60 s (blättern mit ↑ / ↓) |
| M (Video) | Ton aus / an |
| Strg+C (Video) | Aktuelles Videobild kopieren |
| F1 | Tastenkürzel anzeigen |
Alle Tasten lassen sich unter Extras → Tastenkürzel anpassen ändern; F1 zeigt immer die aktuelle Belegung.
KiekAn! arbeitet mit Orca (Linux), NVDA (Windows) und VoiceOver (macOS):
- Beim Blättern sagt KiekAn! das neue Bild an: Dateiname, Position („Bild 17 von 230“) und die Bildbeschreibung aus der Datei. Was angesagt wird, lässt sich unter Einstellungen → Bildschirmleser wählen.
- T erkennt den Text im Bild. Danach steht der Text als Lesetext bereit: ←/→ zeichenweise, Strg+←/→ wortweise, ↑/↓ zeilenweise, Pos1/Ende; mit Umschalt wird markiert, Strg+C kopiert, Esc beendet den Textmodus. Geblättert wird dann mit Bild↑/Bild↓ und der Leertaste. Den Fortschritt der Erkennung sagt KiekAn! an (abschaltbar).
- D öffnet die Bildbeschreibung zum Schreiben oder Ändern.
- Mit Claude: Wer Claude fragt „Was ist auf dem Bild, das ich gerade offen habe?“, bekommt die Antwort, und KiekAn! liest die Beschreibung sofort vor. Auf Wunsch beschreibt Claude auch die nächsten Bilder gleich mit (Anzahl einstellbar); beim Weiterblättern ist die Beschreibung dann schon da. Beim ersten Mal fragt KiekAn!, ob das immer so geschehen soll und ob die Beschreibungen in den Dateien gespeichert werden sollen. Claude sieht dafür nur die Bilder, die es beschreiben soll; KiekAn! selbst sendet nichts.
- Getestet mit Orca 42 unter Ubuntu 22.04. Rückmeldungen von Menschen, die täglich mit einem Bildschirmleser arbeiten, sind sehr willkommen.
KiekAn! hängt nur von Bibliotheken ab, nicht von externen Programmen (auch nicht von exiftool – Metadaten liest und schreibt die Bibliothek exiv2). Alle Bausteine sind optional und auch unter Windows (MSYS2/vcpkg) verfügbar: Qt 6, libmpv, exiv2, Tesseract, qpdf, libheif, LibRaw, OpenJPEG, DjVuLibre.
Damit es überall gleich funktioniert:
- exiv2 0.27 und 0.28, libmpv 1 und 2, Tesseract 4 und 5, qpdf 10 und 11 werden unterstützt.
- Metadaten werden über Qt gelesen/geschrieben und von exiv2 nur im Speicher bearbeitet – keine Probleme mit Umlauten oder Windows-Pfaden; Speichern ist atomar.
- Ohne Icon-Thema (Windows, schlanke Desktops) nutzt KiekAn! Standard-Icons des
Qt-Stils bzw. selbst gezeichnete (
KIEKAN_ICON_THEME=nonezum Ausprobieren). - Tesseract-Sprachdaten in
<Programmordner>/tessdatawerden automatisch verwendet (für eine Windows-Installation oder portable Fassung). - Bildformat-Plugins liegen in
<Programmordner>/qtplugins/imageformatsbzw.lib/kiekan/qtplugins/imageformats.
Benötigt: CMake ≥ 3.16, einen C++17-Compiler und Qt ≥ 6.2.
Ubuntu/Debian:
sudo apt install cmake g++ ninja-build qt6-base-dev qt6-base-dev-tools qt6-l10n-tools libqt6svg6-dev libqt6opengl6-dev qt6-image-formats-plugins qt6-translations-l10n \
libmpv-dev libexiv2-dev qt6-pdf-dev libtesseract-dev libqpdf-dev libheif-dev libraw-dev libopenjp2-7-dev libdjvulibre-dev libturbojpeg0-dev tesseract-ocr-deu tesseract-ocr-eng tesseract-ocr-osd
cmake -S . -B build -G Ninja
cmake --build build
./build/kiekan
ctest --test-dir buildVideo, EXIF und PDF sind optional (-DKIEKAN_WITH_VIDEO=OFF usw.); fehlt eine
Bibliothek, wird ohne die Funktion gebaut.
Fedora:
sudo dnf install cmake gcc-c++ ninja-build rpm-build qt6-qtbase-devel qt6-qtsvg-devel qt6-qttools-devel qt6-qtimageformats qt6-qtpdf-devel \
mpv-devel exiv2-devel tesseract-devel leptonica-devel qpdf-devel libheif-devel LibRaw-devel openjpeg2-devel djvulibre-devel turbojpeg-devel tesseract-langpack-deuopenSUSE Tumbleweed:
sudo zypper install cmake gcc-c++ ninja rpm-build qt6-base-devel qt6-svg-devel qt6-tools-linguist qt6-linguist-devel qt6-imageformats qt6-pdf-devel qt6-opengl-devel \
mpv-devel libexiv2-devel tesseract-ocr-devel leptonica-devel qpdf-devel libheif-devel libraw-devel openjpeg2-devel libdjvulibre-devel 'pkgconfig(libturbojpeg)' tesseract-ocr-traineddata-deuArch Linux: siehe packaging/arch/PKGBUILD.
Paket erzeugen (mit -DCMAKE_INSTALL_PREFIX=/usr konfigurieren):
cd build && cpack -G DEB # Debian, Ubuntu, Mint, Pop!_OS
cd build && cpack -G RPM # Fedora, openSUSEMit kiekan --mcp arbeitet KiekAn! als MCP-Server (Model Context Protocol)
über stdin/stdout. Assistenten wie Claude können damit Bilder ansehen,
untersuchen, bearbeiten und konvertieren – und mit dem offenen KiekAn!-Fenster
zusammenarbeiten.
Einbinden in Claude Code:
claude mcp add --scope user kiekan -- /usr/bin/kiekan --mcpClaude Desktop (claude_desktop_config.json):
{ "mcpServers": { "kiekan": { "command": "/usr/bin/kiekan", "args": ["--mcp"] } } }Beim Flatpak lautet der Befehl flatpak run io.github.codatus.kiekan --mcp
(in Claude Desktop: "command": "flatpak", "args": ["run", "io.github.codatus.kiekan", "--mcp"]).
Das KI-Protokoll liegt dann unter ~/.var/app/io.github.codatus.kiekan/data/kiekan/kiekan/.
| Werkzeug | Zweck |
|---|---|
list_media |
Bilder, PDFs, Videos eines Ordners mit Maßen und Größe |
image_info |
Format, Maße, Seiten, EXIF-Zusammenfassung inkl. GPS |
view_image |
Vorschau oder Ausschnitt in voller Auflösung, optional mit Koordinatengitter |
read_metadata |
alle EXIF/IPTC/XMP-Einträge, filterbar |
histogram |
Tonwert-Kennzahlen je Kanal, Anteil abgeschnittener Lichter/Schatten |
list_filters |
verfügbare Filter (inkl. Plugins) mit Parametern |
edit_image |
Kette aus Drehen, Spiegeln, Zuschneiden, Größe, Kurven, Filtern → neue Datei |
convert_batch |
viele Dateien/ganzen Ordner umwandeln, verkleinern, bearbeiten |
viewer_show |
Datei im Fenster öffnen (startet KiekAn! bei Bedarf) |
viewer_state |
was der Benutzer gerade sieht, inkl. markiertem Bereich |
viewer_get_image |
angezeigtes Bild bzw. markierten Bereich, auch mit ungespeicherten Änderungen |
viewer_select |
einen Bereich im Fenster markieren, um darauf zu zeigen |
viewer_apply |
Bearbeitung als ungespeicherten Vorschlag im Fenster zeigen (Strg+S / Strg+Z) |
viewer_describe |
Bildbeschreibung ans Fenster geben – KiekAn! liest sie mit dem Bildschirmleser vor (auch vorab für die nächsten Bilder) |
contact_sheet |
viele Bilder nummeriert auf einem Blatt – zum Sichten ganzer Ordner |
extract_text |
Text aus PDF-Textebene oder per OCR, Sprache automatisch, optional mit Wortrahmen |
ocr_languages |
installierte OCR-Sprachpakete und wie man weitere installiert |
write_metadata |
Titel, Beschreibung, Alternativtext, Stichwörter, Bewertung in die Datei schreiben (XMP/IPTC/EXIF) |
split_pdf |
große PDFs in dokumentierte Teile zerlegen (z. B. unter 30 MB für Claude) |
pdf_parts |
Teile einer Teilung auflisten, Originalseite → Teil nachschlagen, Teile prüfen |
Eine KI liest über KiekAn! fremde Dateien. Text darin – Texterkennung, PDF-Text, Metadaten, Dateinamen – kann Anweisungen an die KI enthalten („Prompt Injection“). KiekAn! begrenzt deshalb, was eine KI tun kann:
- Ordnerfreigaben (Extras → Einstellungen → KI-Schnittstelle): Die KI liest nur in freigegebenen Leseordnern und speichert nur in Schreibordnern (die sie auch lesen darf). Ohne Freigabe hat sie keinen Dateizugriff bzw. darf nichts speichern. Üblich ist ein eigener, leerer Unterordner eines Leseordners zum Schreiben. Liegen Leseordner selbst im Schreibbereich, weist der Dialog darauf hin. Symlinks, die aus den Freigaben hinausführen, werden nicht verfolgt – weder beim Lesen noch beim Schreiben.
- Ausnahme: das offene Fenster. Beim ersten Start fragt KiekAn!, ob
KI-Assistenten das offene Fenster nutzen dürfen; vorgeschlagen ist „aus“.
Solange „KI-Assistenten dürfen das offene Fenster abfragen und steuern“
eingeschaltet ist, sieht die KI über
viewer_stateundviewer_get_imagedas Bild, das gerade im Fenster angezeigt wird – auch außerhalb der Leseordner. Das KI-Protokoll verzeichnet jeden solchen Zugriff. Ändern lässt sich das jederzeit in den Einstellungen. - Nichts Vorhandenes ändern, solange „KI darf vorhandene Dateien ersetzen
und Metadaten ändern“ aus ist: kein
overwrite=true, keinwrite_metadata. - Werkzeug-Kennzeichnung: Jedes Werkzeug meldet per MCP, ob es nur liest
(
readOnlyHint) oder Dateien verändern kann (destructiveHint). Claude Desktop kann für Letztere nachfragen – dort für KiekAn! die schreibenden Werkzeuge auf „Immer fragen“ lassen. - Fremden Text kennzeichnen: Text aus Dateien steht zwischen
<<<FILE-CONTENT …>>>-Markierungen mit zufälliger Kennung; die KI erhält die Anweisung, ihn nur als Daten zu behandeln. - Verdächtiges melden: KiekAn! sucht nach typischen Mustern (deutsch und
englisch: „ignoriere alle bisherigen Anweisungen“, Rollenwechsel,
Chat-Steuerzeichen, Aufforderungen zu Werkzeugaufrufen oder zum Versenden
von Daten) sowie nach unsichtbaren Zeichen und verstecktem Unicode-Tag-Text.
Funde stehen als
SECURITY NOTICEvor dem Ergebnis, im Protokoll und – wenn KiekAn! offen ist – in einem Hinweisfenster. - Vertrauenswürdige Ordner: Unter den Leseordnern lassen sich die
ankreuzen, die nur eigene Dateien enthalten. Dort warnt KiekAn! nicht bei
verdächtigem Text (Funde stehen nur grau im Protokoll); Kennzeichnung,
Protokoll und Rechte bleiben. Dateien, die die KI in Schreibordnern ablegt,
gelten nur dann als vertrauenswürdig, wenn sie nachweislich aus einem
vertrauenswürdigen Ordner stammen, seitdem unverändert sind und die KI keine
eigenen Metadaten hineingeschrieben hat (Herkunftsregister
ki-herkunft.jsonim Datenordner). So kann eingeschleuster Text aus fremden Dateien nicht über eine KI-Kopie „vertrauenswürdig“ werden. Für Download-, Temp- und Mail-Ordner rät der Dialog ab. - KI-Protokoll (Extras → KI-Protokoll): jeder Werkzeugaufruf mit Zeit,
Programm, gelesenen und geschriebenen Dateien und Warnungen; Datei
ki-protokoll.jsonlim Datenordner von KiekAn!
Das senkt das Risiko, verhindert Prompt Injection aber nicht vollständig. Fremde Dokumente am besten in einem Chat ohne Web- oder E-Mail-Werkzeuge auswerten.
Für Tests lassen sich Freigaben auch per Umgebung setzen:
KIEKAN_MCP_ROOTS, KIEKAN_MCP_WRITE_ROOTS, KIEKAN_MCP_TRUSTED_ROOTS (Ordner, durch : bzw. ;
getrennt) und KIEKAN_MCP_ALLOW_OVERWRITE=1.
Claude Desktop nimmt PDFs nur bis 30 MB an. split_pdf (bzw. Datei → PDF teilen)
zerlegt größere Dateien – standardmäßig in Teile von höchstens 25 MB. Die Größe
wird gemessen, nicht geschätzt; geschnitten wird möglichst an Lesezeichen
(Bände, Abschnitte). Die Originaldatei bleibt unverändert.
- Dateinamen:
Akte_Teil-02-von-05_S0101-0200.pdf - Seitenbeschriftung: In PDF-Betrachtern zeigt jeder Teil die Originalseitenzahlen.
- Dokumenteigenschaften jedes Teils: Titel, Thema und Stichwörter nennen Quelle, Teilnummer, Seitenbereich und Prüfsumme der Quelle.
- Protokoll
Akte_Teilung.json(für Programme/KI) undAkte_Teilung.md(zum Lesen): Quelle mit SHA-256, Teile mit Seitenbereich, Größe, SHA-256 und den darin liegenden Lesezeichen. pdf_partsfindet zu jeder Originalseite den Teil und die Seite darin und prüft, ob Teile fehlen oder verändert wurden.
Tesseract verteilt einzelne Seiten über OpenMP auf mehrere Threads – das bringt
kaum Tempo, belegt aber die Prozessoren (gemessen: +7 % Geschwindigkeit für
doppelte Rechenlast). KiekAn! startet die Erkennung deshalb wie ocrmypdf in
Hilfsprozessen (kiekan --ocr-worker) mit OMP_THREAD_LIMIT=1 und liest
stattdessen mehrere Seiten parallel. Die Grenze muss beim Prozessstart gesetzt
sein, weil die OpenMP-Bibliothek sie beim Laden einliest.
- Tesseract-OSD bestimmt Schrift (lateinisch, Fraktur, kyrillisch …) und Lage; gedrehte Seiten werden aufgerichtet.
- Eine Probe-Erkennung auf einem Seitenstreifen wird an typischen Füllwörtern
einer von 17 Sprachen zugeordnet – auch wenn deren Sprachpaket fehlt. Dann
nennt das Ergebnis das fehlende Paket (z. B.
tesseract-ocr-fra). - Die passenden installierten Pakete (z. B.
deugegendeu_latffür Fraktur) werden auf der Probe verglichen: Erkennungssicherheit plus Füllwort-Anteil. Bei gemischtsprachigen Texten werden zwei Pakete kombiniert.
Das Ergebnis enthält die gewählte Sprache, die Sicherheit, die Rangliste der Kandidaten und Hinweise.
Sicherheit: nur absolute Pfade; geschrieben wird nur in ausdrücklich genannte
Zieldateien, nie überschrieben ohne overwrite; es gibt kein Löschwerkzeug.
Unter Extras → Einstellungen → KI-Schnittstelle lässt sich der Zugriff auf
bestimmte Ordner beschränken und der Zugriff auf das offene Fenster abschalten.
Die Umgebungsvariablen KIEKAN_MCP_ROOTS, KIEKAN_MCP_WRITE_ROOTS und
KIEKAN_MCP_TRUSTED_ROOTS (Pfade, getrennt wie PATH) ergänzen die Ordner
aus den Einstellungen, sie ersetzen sie nicht. Die Fensterverbindung ist ein
lokaler Socket im privaten Laufzeitordner des Benutzers ($XDG_RUNTIME_DIR);
beide Seiten prüfen, dass die Gegenseite demselben Benutzer gehört. Unter
Windows ist es eine Named Pipe mit den Standardrechten des Benutzers.
Sind mehrere Fenster offen, sieht die KI standardmäßig das zuletzt benutzte;
in den Einstellungen lässt sich stattdessen das zuerst geöffnete wählen (unter
Windows gilt immer das zuerst geöffnete). Mit der Umgebungsvariable
KIEKAN_VIEWER_SOCKET=<name> (für Fenster und kiekan --mcp gleich gesetzt)
bekommt eine Instanz eine eigene Verbindung – praktisch für Tests neben einem
normal laufenden KiekAn!
Filter-Plugins sind Qt-Plugin-Bibliotheken, die die Schnittstelle aus
include/kiekan/FilterInterface.h
implementieren. KiekAn! erzeugt für jeden Filter automatisch einen Dialog mit
Reglern und Live-Vorschau. Gesucht wird in
<Programmordner>/plugins~/.local/share/kiekan/plugins<Bibliotheksordner>/kiekan/pluginsder Installation (z. B./usr/lib/x86_64-linux-gnu/kiekan/pluginsunter Debian/Ubuntu,/usr/lib64/kiekan/pluginsunter Fedora/openSUSE)
Ein vollständiges Beispiel liegt in plugins/rahmen.
Die Texte im Quellcode sind deutsch. Weitere Sprachen liegen als Qt-Linguist-
Dateien in translations/. Nach Codeänderungen aktualisieren:
/usr/lib/qt6/bin/lupdate src plugins -source-language de -target-language en -ts translations/kiekan_en.tsKiekAn! sendet nichts ins Internet – keine Telemetrie, keine Update-Abfrage, kein Nachladen. Das gilt auch für die Bibliotheken:
- Videos (libmpv): keine mpv-Konfiguration, keine Skripte (kein youtube-dl), erlaubt sind nur lokale Dateien. Eine präparierte Datei, die Teile aus dem Netz nachladen will, wird nicht ausgeführt.
- SVG, PDF, Metadaten, Texterkennung und alle Bildformate arbeiten nur mit der geöffneten Datei.
- Die KI-Schnittstelle spricht nur über die Standardein-/ausgabe mit dem aufrufenden Programm und über einen lokalen Socket mit dem eigenen Fenster.
- Einzige Ausnahme, nur auf Klick: „In OpenStreetMap zeigen“ im EXIF-Dialog öffnet den Browser mit den GPS-Koordinaten des Fotos.
Das Flatpak hat zusätzlich keine Netzwerkberechtigung. Geprüft wird das mit
packaging/test/netztest.sh: Während aller
Tests und mit Köderdateien wird jeder Verbindungsversuch protokolliert.
Die Fotos in den Bildschirmfotos stehen unter CC0 (Wikimedia Commons): Leuchtturm Mellumplate von Nane Kratzke, Neuer Leuchtturm Borkum von Uwe Jelting. Der Brief ist ausgedacht.
Copyright © 2026 Carl Kliefert
KiekAn! ist freie Software: Sie dürfen es unter den Bedingungen der GNU General Public License, Version 3 oder (nach Ihrer Wahl) jeder späteren Version, weitergeben und verändern. Siehe LICENSE.



