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
- Bildpfad besorgen. Bei einer URL zuerst mit
curl -L -o /tmp/in.jpg URLherunterladen. - Ausgabe wählen. Für die Anzeige im Chat stdout verwenden. Wenn der Benutzer eine Datei zum Teilen möchte,
-o datei.pngoder-o datei.htmlnutzen. - Ausführen, dann das Ergebnis lesen. Bei einem PNG das Bild öffnen und betrachten.
- Falls das Motiv schwer zu erkennen ist, nachjustieren und erneut ausführen (siehe „Schwache Ergebnisse verbessern“).
Optionen
| Option | Wirkung |
|---|---|
-w 100 | Breite in Zeichen (1–1000). Für Chat 60–80, für PNG/HTML 120–200, für Bildschirmfotos von Text 120+. |
-c standard | Zeichenrampe: standard, detailed, blocks, terminal, minimal, binary, dots oder eine eigene Zeichenkette von dicht zu leer, z.B. -c "#*. ". |
-o ausgabe.png | Ausgabe nach Endung: .txt, .html, .png, .jpg, .webp. Ohne -o wird Klartext auf stdout ausgegeben. |
--bg black | Hintergrund: 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 matrix | Eine Tuschefarbe: matrix, amber, cyan, magenta, mint oder eine beliebige CSS-Farbe oder hex. Ohne Angabe verwenden PNG/HTML die eigenen Farben des Fotos. |
--color | Truecolor-ANSI-Escapecodes in der Textausgabe (stdout oder .txt). Verwendet --fg falls angegeben, sonst die Fotofarben. |
--invert | Hell und Dunkel vertauschen. |
--contrast 1.0 --brightness 1.0 | Faktoren zusätzlich zur automatischen Kontrastdehnung. 1.0 bedeutet keine Änderung. |
--dither | Floyd-Steinberg-Dithering. Gut für weiche Farbverläufe und kurze Rampen wie blocks oder minimal. |
--mode ramp | ramp (Standard): ein Glyph pro Pixel, nach Helligkeit ausgewählt. shape: wie ramp, aber Kanten werden mit Symbolen derselben Form (`/ \ |
--sharpen | Schärft Kanten vor der Verkleinerung. Hilft bei Gesichtern und feinen Details, besonders im braille-Modus. |
--aspect 0.5 | Zeichenbreite geteilt durch Höhe. Erhöhen, wenn die Kunst gestaucht aussieht. |
--font-size 12 | Glyphengröße in px für PNG/HTML. |
--glow 0.8 | Weiches 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 --ditherergibt die erkennbarsten Gesichter und Tiere. - Dunkles Motiv (schwarzer Hund, Nachtszene) verschwindet auf schwarzem Hintergrund:
--bg whiteverwenden. Auch die Erhöhung von--brightness 1.5hilft. Kontrasterhöhung verschlechtert dunkle Szenen. - Dunkles Logo auf weißem Hintergrund erscheint als einfarbiger Block:
--bg whitehinzufügen (oder--invertfür Terminalausgabe). - Mehr Details bei gleicher Breite gewünscht:
--mode braille --dither --sharpenfür Strichzeichnungen,--mode halfblockfür ein Farbfoto. - Zu viel Rauschen: Weniger Spalten oder eine kürzere Rampe verwenden (
-c minimal). - Streifenbildung in Farbverläufen:
--ditherhinzufügen. - Chat-Ausgabe: Niemals
--colorverwenden, 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
brailleignoriert-c. Mit--ditherfür Fotos verwenden, ohne für Logos. Farben folgen dem Foto oder--fg.halfblockignoriert-c,--ditherund--fg, da die Farben das Bild sind. Klartext (ohne--color) hat keine Farben, daher wird jede Zelle ein Schattierungsblock█▓▒░entsprechend der Helligkeit.--bg nonemacht 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 Nwählt einen anderen Satz aus.-cangeben, 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.--gapsetzt den px-Abstand zwischen Boxen in gestapelten Zeilen.--seedwählt ein anderes Layout.--fgwird ignoriert. - Es funktioniert am besten bei einem hellen, einfachen Motiv auf dunklem Hintergrund. Bei einem dunklen Motiv auf hellem Foto
--inverthinzufügen. - In
animate.pybleibt 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.
--fpstastet neu ab.--startund--durationwählen einen Ausschnitt in Sekunden. - Es stoppt standardmäßig bei 300 Frames und meldet dies.
--max-frameserhöhen oder--fpssenken 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 0schaltet es aus. - Zeilensprung-Video wird deinterlaced, und Video mit nicht quadratischen Pixeln behält seine echte Form.
--ditherfü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..mp4oder.webpfü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 whiteverwenden. --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 60bis-w 100verwenden.--mode halfblockergibt die beste Farbe;--mode brailledie schärfsten Linien.- Ohne
-owird die Szene im Terminal abgespielt. - Eine Szene ist eine einfache Funktion in
scripts/scenes.py:scene(w, h, n, seed)gibtnBilder 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.
- 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--listausführen, dann--pick N. - 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 5hinzufügen. - Ein Bild des Ergebnisses betrachten. Wenn das Motiv schwer zu erkennen ist, mit
--pickein anderes Ergebnis versuchen. - 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")]