CommunityBildgithub.com

ASCII-Kunst

Verwandle jedes Bild, GIF oder Video in ASCII-Kunst oder ASCII-Animation – als Klartext, Truecolor-Terminalausgabe, HTML, PNG, GIF, WebP oder MP4. Animiert auch Standbilder mit Matrix-Regen, Decode-, Scan-, Glitch- und Welleneffekten. Erstellt aus einer kurzen Beschreibung wie „ein rennendes Pferd“ eine ASCII-Animation unter Verwendung eines frei lizenzierten Clips von Wikimedia Commons.

Was ist ASCII-Kunst?

Dieses Skill bietet zwei Hauptskripte: `scripts/ascii.py` für Standbilder und `scripts/animate.py` für Animationen. Beide benötigen nur Python 3.9+ und Pillow sowie optional ffmpeg für Videoausgabe. Mit `uv run` werden Abhängigkeiten automatisch installiert. Der Skill unterstützt eine Vielzahl von Ausgabeformaten (Text, HTML, PNG, GIF, WebP, MP4) und zahlreiche Anpassungsoptionen wie Zeichenrampen (`-c`), Modi (`--mode` für Braille, Halbblock, Wort- oder Kachelposter), Farben, Kontrast, Dithering und Voreinstellungen (z.B. Matrix, Retro Amber, Film Noir). Für Animationen gibt es Effekte (Matrix, Decode, Scan, Glitch, Wave) für Standbilder sowie eingebaute Szenen (Feuer, Donut, Würfel, Wellen, Sterne, Regen, Hüpfer, ASCII-Text). Der Skill kann auch aus einer kurzen Beschreibung wie „ein rennendes Pferd“ automatisch einen passenden Clip von Wikimedia Commons suchen und herunterladen (`scripts/fetch.py`). Die API kann auch direkt in Python–Code genutzt werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rasabaq/ascii-skill/tree/HEAD

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht ASCII-Kunst?

scripts/ascii.py erstellt Standbilder und scripts/animate.py Animationen (siehe „Animation“). Beide benötigen nur Python 3.9+ und Pillow (plus ffmpeg für Videos). Mit installiertem uv holt uv run Pillow automatisch.

uv run scripts/ascii.py BILD [Optionen]          # oder: python3 scripts/ascii.py (benötigt pillow)

Pfade unten sind relativ zum Ordner dieses Skills.

Schritte

  1. Bildpfad besorgen. Bei einer URL zuerst mit curl -L -o /tmp/in.jpg URL herunterladen.
  2. Ausgabe wählen. Für die Anzeige im Chat stdout verwenden. Wenn der Benutzer eine Datei zum Teilen möchte, -o datei.png oder -o datei.html nutzen.
  3. Ausführen, dann das Ergebnis lesen. Bei einem PNG das Bild öffnen und betrachten.
  4. Falls das Motiv schwer zu erkennen ist, nachjustieren und erneut ausführen (siehe „Schwache Ergebnisse verbessern“).

Optionen

OptionWirkung
-w 100Breite in Zeichen (1–1000). Für Chat 60–80, für PNG/HTML 120–200, für Bildschirmfotos von Text 120+.
-c standardZeichenrampe: standard, detailed, blocks, terminal, minimal, binary, dots oder eine eigene Zeichenkette von dicht zu leer, z.B. -c "#*. ".
-o ausgabe.pngAusgabe nach Endung: .txt, .html, .png, .jpg, .webp. Ohne -o wird Klartext auf stdout ausgegeben.
--bg blackHintergrund: black (Standard), white, none (transparentes PNG/HTML) oder eine beliebige Farbe. Auf dunklem Hintergrund erhalten helle Pixel dichte Glyphen. Auf hellem Hintergrund tun dies dunkle Pixel.
--fg matrixEine Tuschefarbe: matrix, amber, cyan, magenta, mint oder eine beliebige CSS-Farbe oder hex. Ohne Angabe verwenden PNG/HTML die eigenen Farben des Fotos.
--colorTruecolor-ANSI-Escapecodes in der Textausgabe (stdout oder .txt). Verwendet --fg falls angegeben, sonst die Fotofarben.
--invertHell und Dunkel vertauschen.
--contrast 1.0 --brightness 1.0Faktoren zusätzlich zur automatischen Kontrastdehnung. 1.0 bedeutet keine Änderung.
--ditherFloyd-Steinberg-Dithering. Gut für weiche Farbverläufe und kurze Rampen wie blocks oder minimal.
--mode rampramp (Standard): ein Glyph pro Pixel, nach Helligkeit ausgewählt. shape: wie ramp, aber Kanten werden mit Symbolen derselben Form (`/ \
--sharpenSchärft Kanten vor der Verkleinerung. Hilft bei Gesichtern und feinen Details, besonders im braille-Modus.
--aspect 0.5Zeichenbreite geteilt durch Höhe. Erhöhen, wenn die Kunst gestaucht aussieht.
--font-size 12Glyphengröße in px für PNG/HTML.
--glow 0.8Weiches Leuchten um die Glyphen (0-1) in PNG, HTML und Animation, wie Licht auf einem alten Bildschirm. Am besten auf dunklem Hintergrund.

Schwache Ergebnisse verbessern

Das Skript dehnt bereits jedes Bild auf seinen vollen Tonwertumfang, sodass die meisten Bilder ohne Anpassung gut aussehen.

  • Fotos: -c blocks --dither ergibt die erkennbarsten Gesichter und Tiere.
  • Dunkles Motiv (schwarzer Hund, Nachtszene) verschwindet auf schwarzem Hintergrund: --bg white verwenden. Auch die Erhöhung von --brightness 1.5 hilft. Kontrasterhöhung verschlechtert dunkle Szenen.
  • Dunkles Logo auf weißem Hintergrund erscheint als einfarbiger Block: --bg white hinzufügen (oder --invert für Terminalausgabe).
  • Mehr Details bei gleicher Breite gewünscht: --mode braille --dither --sharpen für Strichzeichnungen, --mode halfblock für ein Farbfoto.
  • Zu viel Rauschen: Weniger Spalten oder eine kürzere Rampe verwenden (-c minimal).
  • Streifenbildung in Farbverläufen: --dither hinzufügen.
  • Chat-Ausgabe: Niemals --color verwenden, da Escape-Codes als Müll angezeigt werden. Den Text in einen Codeblock einschließen.
  • SVG wird nicht unterstützt. Zuerst in PNG konvertieren (rsvg-convert -w 800 logo.svg -o logo.png).

Modi kurz erklärt

  • braille ignoriert -c. Mit --dither für Fotos verwenden, ohne für Logos. Farben folgen dem Foto oder --fg.
  • halfblock ignoriert -c, --dither und --fg, da die Farben das Bild sind. Klartext (ohne --color) hat keine Farben, daher wird jede Zelle ein Schattierungsblock █▓▒░ entsprechend der Helligkeit. --bg none macht es nicht transparent: transparente Pixel werden schwarz.
  • Terminals zeichnen Braille-Punkte klein, daher wirkt Braille dort matter als in einem PNG.

Kachelposter

--mode tiles erstellt ein Poster: ein Raster aus quadratischen Kacheln in wenigen ruhigen Farben, jede mit einem Glyph, auf einer anthrazitfarbenen Seite. Wo das Bild nahe an der Seitenfarbe liegt, werden Zellen nicht zu Kacheln: Sie zeigen einen blassen Glyphen, sodass das Raster überall weitergeht.

uv run scripts/ascii.py photo.jpg --mode tiles -w 36 -o poster.png
  • Standardeinstellungen im Kachelmodus: quadratische Zellen (--aspect 1), --font-size 80 (48 px Kacheln), --gap 1, --bg "#1d1f22". Die Textausgabe behält --aspect 0.5.
  • --palette 8: Anzahl der Kachelfarben, einmalig aus dem Motiv ausgewählt. 4–6 für einen flacheren, ruhigeren Look verwenden.
  • Glyphen sind zufällig. --seed N wählt einen anderen Satz aus. -c angeben, um stattdessen Rampenglyphen zu verwenden.
  • Foto mit hellem Hintergrund: Helle Seite verwenden, wie --bg "#ecebe6". Dann werden dunkle Teile zu Kacheln.
  • Funktioniert auch in animate.py. Glyphen und Farben bleiben von Frame zu Frame gleich.

Wortposter

--mode words füllt die Leinwand mit Großbuchstaben-Wörtern, durch ein Leerzeichen getrennt. Jede Zeile beginnt mit eigenem Versatz und läuft an beiden Rändern über. Das Bild zeigt sich nur durch die Helligkeit jedes Wortes: eine Stufe pro Wort, aus dem Mittelwert des darunterliegenden Bildes. Dunkle Teile ergeben blasse Wörter, das Motiv helle Wörter.

  • --words "A B C" legt den Wortschatz fest (Leerzeichen oder Komma getrennt). Die Voreinstellung ist eine kurze Liste von Typ- und Pixel-Wörtern.
  • --accent "#f28c28" setzt eine solide Box hinter die farbigsten Wörter, mit dunklem Text. --accent-level 0.5 (0-1) gibt an, wie bunt ein Wort sein muss. Graue Fotos erhalten keine Boxen; ein vollfarbiges Logo erhält viele, also den Wert erhöhen.
  • Der Hintergrund ist standardmäßig #1d1f22. --gap setzt den px-Abstand zwischen Boxen in gestapelten Zeilen. --seed wählt ein anderes Layout. --fg wird ignoriert.
  • Es funktioniert am besten bei einem hellen, einfachen Motiv auf dunklem Hintergrund. Bei einem dunklen Motiv auf hellem Foto --invert hinzufügen.
  • In animate.py bleibt das Layout in jedem Frame gleich; nur die Helligkeit ändert sich.

Voreinstellung: --mode words -w 110 --font-size 16 --accent "#f28c28" -o poster.png

Voreinstellungen

  • Matrix: -c binary --fg matrix --glow 0.8 -o out.png
  • Retro-Amber-Terminal: -c terminal --fg amber -o out.png
  • Fotmosaik in Farbe: -c detailed -w 160 -o out.html
  • Bestes Farbfoto im Terminal: --mode halfblock --color
  • Feine Punktzeichnung: --mode braille --dither --sharpen -o out.png
  • Film Noir: --fg "#e8e6df" --contrast 1.35 --bg "#050505" --glow 0.7 -o out.png
  • Druckfreundlich: --bg white -o out.png
  • Kachelposter: --mode tiles -w 36 -o poster.png

Animation

scripts/animate.py erstellt ASCII-Animation. Es verwendet dieselben Look-Optionen wie ascii.py (-w, -c, --mode, --sharpen, --bg, --fg, --invert, --contrast, --brightness, --font-size, --aspect, --gap, --glow und die Wort- und Kachelposter-Optionen). Video-Eingabe und .mp4-Ausgabe benötigen ffmpeg. GIF und WebP nicht.

uv run scripts/animate.py katze.gif                          # Im Terminal abspielen, Strg-C stoppt
uv run scripts/animate.py katze.gif -o out.gif               # auch .webp, .mp4 oder .html (eine Datei mit Play/Pause-Player)
uv run scripts/animate.py clip.mp4 -o out.html --start 2 --duration 4 --fps 12
uv run scripts/animate.py photo.jpg --effect matrix -o intro.gif   # Standbild animieren
  • Eingabe: animiertes GIF, WebP oder APNG, jedes Video, das ffmpeg liest, oder ein Standbild mit --effect.
  • Das Frame-Timing stammt von der Quelle. --fps tastet neu ab. --start und --duration wählen einen Ausschnitt in Sekunden.
  • Es stoppt standardmäßig bei 300 Frames und meldet dies. --max-frames erhöhen oder --fps senken für längere Clips.
  • Ein Tonwertbereich (und bei Braille ein Punktschwellwert) wird für alle Frames verwendet, sodass die Helligkeit nicht pulsiert.
  • Stille Bereiche flackern nicht: Ein Pixel behält seinen Wert, bis er sich um mehr als --steady ändert (Standard 6, von 255). Für körniges Film auf 16 oder mehr erhöhen. --steady 0 schaltet es aus.
  • Zeilensprung-Video wird deinterlaced, und Video mit nicht quadratischen Pixeln behält seine echte Form.
  • --dither für Animationen vermeiden: Es lässt die Glyphen von Frame zu Frame kriechen.
  • GIF kann nicht schneller als etwa 50 fps abspielen, daher verwirft schnelles Video einige Frames in .gif. .mp4 oder .webp für flüssige 60 fps verwenden.

Figuren auf einfarbigem Hintergrund

Für eine dunkle Figur auf hellem Hintergrund, wie das rennende Pferd von Muybridge, --bg white verwenden. Dann erhält die Figur die Tusche und die Seite bleibt sauber. --mode braille ergibt die schärfste bewegte Figur, und --mode halfblock behält die Töne des Fotos.

uv run scripts/animate.py horse.gif --mode braille --bg white -o horse.gif
uv run scripts/animate.py juggler.webm --start 17 --duration 4 --mode braille --subject -o juggler.gif

--subject behält nur, was sich bewegt, und malt den Rest als leere Seite (weiß, wenn der Hintergrund hell ist, es sei denn, Sie setzen --bg). Es benötigt eine ruhige Kamera: Es nimmt den Hintergrund aus dem Median von bis zu 25 Frames. Hinweise:

  • Teile, die die meiste Zeit des Clips stillhalten, wie ein Kopf, gelten als Hintergrund und blenden aus.
  • Wenn sich die Bildränder ständig ändern, bewegt sich die Kamera: Es meldet dies und belässt die Frames wie sie sind. Eine langsame Schwenkung wird nicht immer erkannt und hinterlässt Konturen.
  • In Clips, in denen jeder Frame ein anderes Foto ist (Muybridges Pferd und Büffel), stattdessen --bg white verwenden.
  • --subject-cut (Standard 40, von 255) gibt an, wie sehr sich ein Pixel vom Hintergrund unterscheiden muss, um zu zählen. Für eine blasse Figur senken, für verrauschtes Video erhöhen.

Effekte für Standbilder

--effect NAME verwandelt ein Bild in einen 2 bis 3,2 Sekunden langen Intro-Clip mit 25 fps, der auf der fertigen Kunst endet und diese 1,5 Sekunden hält. Jeder Effekt funktioniert mit jedem Modus.

  • matrix: Fallende Säulen von Glyphen mit einem hellen Kopf, die die Kunst hinter sich lassen.
  • decode: Zellen durchlaufen wahllos Glyphen und verriegeln sich, indem sie von links nach rechts streichen.
  • scan: Eine helle CRT-Linie streicht nach unten und tippt jede Zeile ein, mit einem kurzen Leuchten.
  • glitch: Kurze Ausbrüche von zerrissenen Zeilen, Glyphenaustausch und rot/cyan Bändern. Schleift gut.
  • wave: Zeilen schwanken seitwärts auf einer Sinuswelle, die anschwillt und sich beruhigt. Schleift gut.

Szenen

--scene NAME zeichnet eine sich wiederholende Animation im Code, sodass keine Eingabedatei benötigt wird. Jede Schleife dauert 2 bis 3,2 Sekunden, und der letzte Frame fließt in den ersten. Jeder Modus, jede Farboption und jede Ausgabe funktioniert. --seed N ergibt eine andere Variante (Feuer, Wellen, Sterne, Regen), und --fps ändert die Glätte, behält aber die Schleifenlänge bei.

uv run scripts/animate.py --scene fire -o fire.gif                       # Aufsteigende Flammen, warme Farben
uv run scripts/animate.py --scene donut -o donut.gif                     # Ein sich drehender, beleuchteter, glasierter Donut
uv run scripts/animate.py --scene cube --mode braille -o cube.gif        # Ein purzelnder Würfel mit hellen Kanten
uv run scripts/animate.py --scene waves --mode halfblock -o waves.gif    # Meeresdünung unter dem Mond
uv run scripts/animate.py --scene stars -o stars.gif                     # Flug durch ein Sternenfeld
uv run scripts/animate.py --scene walker --mode braille -o run.gif       # Ein Strichmännchen, das auf der Stelle rennt
uv run scripts/animate.py --scene rain --mode braille -o rain.gif        # Regen mit Spritzern
uv run scripts/animate.py --scene bounce --mode halfblock -o ball.gif    # Ein Ball, der beim Aufprall gestaucht wird
uv run scripts/animate.py --scene text --mode halfblock -o text.gif      # Das Wort ASCII reitet auf einer Regenbogenwelle
  • -w 60 bis -w 100 verwenden. --mode halfblock ergibt die beste Farbe; --mode braille die schärfsten Linien.
  • Ohne -o wird die Szene im Terminal abgespielt.
  • Eine Szene ist eine einfache Funktion in scripts/scenes.py: scene(w, h, n, seed) gibt n Bilder zurück, die sich wiederholen. Um eine hinzuzufügen, schreiben Sie die Funktion und geben Sie ihr die Zeile @scene(width, height, frames, fps).

Aus einer Beschreibung

Wenn der Benutzer ein sich bewegendes Ding („ein rennendes Pferd“) beschreibt, anstatt eine Datei zu nennen, suchen Sie zuerst einen freien Clip. scripts/fetch.py durchsucht Wikimedia Commons nach animierten GIFs und kurzen Videos mit einer freien Lizenz und lädt den besten Treffer herunter.

  1. Clip holen: uv run scripts/fetch.py "running horse" -o /tmp/clip. Es fügt die richtige Endung hinzu (.gif, .webm), gibt dann den gespeicherten Pfad und eine Quellenangabe aus. Zur eigenen Auswahl zuerst mit --list ausführen, dann --pick N.
  2. Den ausgegebenen Pfad konvertieren: uv run scripts/animate.py /tmp/clip.gif --mode braille -w 80 --bg white -o out.gif. Jede Voreinstellung funktioniert. Bei langen Videos --duration 5 hinzufügen.
  3. Ein Bild des Ergebnisses betrachten. Wenn das Motiv schwer zu erkennen ist, mit --pick ein anderes Ergebnis versuchen.
  4. Dem Benutzer die Quellenangabe zusammen mit dem Ergebnis geben. Die meisten Lizenzen (CC BY, CC BY-SA) erfordern sie.

Mit kurzen, einfachen englischen Wörtern nach Motiv und Bewegung suchen. Strichzeichnungen, Silhouetten und Clips auf einfarbigem Hintergrund ergeben die beste ASCII-Kunst. Bewegte reale Videos oft nicht.

Wenn nichts Passendes gefunden wird, stattdessen eine codeseitig gezeichnete Szene verwenden: animate.py --scene NAME (siehe „Szenen“).

Python-Verwendung

import sys; sys.path.insert(0, "scripts")
from PIL import Image
from ascii import convert, to_text, to_png
grid = convert(Image.open("cat.jpg"), width=80, charset="blocks", dither=True)
# Zellen sind (char, (r, g, b)). Bei mode="halfblock" sind sie (char, top_rgb, bottom_rgb).
# Bei mode="tiles" sind Kachelzellen (char, ink_rgb, tile_rgb).
print(to_text(grid))
to_png(grid).save("cat_ascii.png")

from effects import frames  # Liste von Rastern; das letzte ist `grid`
intro = [to_png(g) for g in frames(grid, "decode")]

Verwandte Skills