asciipaper

Live, interactive ASCII wallpapers for Windows, Linux, macOS and Android. One click turns any wallpaper into one of 60 styles: LEGO bricks, pixel art, voxel cubes, CRT glass, Game Boy, CMYK print, Matrix code and more. Port any picture, GIF, video or post on X into ASCII art that moves on your desktop, or ask Claude to design a new one for you. Free, open source, and light on your GPU.

▶ Try it live in your browser · ⬇ Download for Windows 10 and 11 · Linux: one command · macOS: with Plash · Android (asciipaper-….apk)

• Light. A small native engine (C, OpenGL ES) draws on the GPU: under 1% of a CPU core and about 100 MB on Linux. Wallpapers stop drawing behind fullscreen and maximized windows, and while the PC is locked.
• Calm by default. Wallpapers react to the pointer like liquid (fluid, yin-yang) and never chase it. Click ripples and the hover lens are there if you want them (Settings, Customize).
• Port anything. Pictures, GIFs, videos, links, and posts on X or Twitter. asciipaper measures the media and picks a starting look: levels, colours, and which parts get the dense characters.
• Discover packs. 27 ready-made wallpapers in six moods (Calm, Retro, Neon, Print and paper, Hacker, Toys), one click each, in every app. From a terminal: asciipaper packs, then asciipaper add still-ocean.
• Interaction you choose. Each wallpaper can glow where your pointer is, magnify, push away, pull in, swirl or ripple, at the strength you like, or simply stay still.
• Calm by choice. One Speed slider, right under your wallpaper, slows any scene down (or speeds it up) everywhere: Linux, Windows, Mac and Android. From a terminal: asciipaper speed 0.5.
• 60 styles, live. Pick a style, then fine-tune shapes, 21 character sets, 30 palettes, dithering, CRT, VHS, bloom, glitch, film leaks, tilt shift, pixel sorting and warps. Everything changes on your desktop as you move the sliders.
• Share a look in one line. Every look is a short recipe code, and every PNG you render carries its own, so a screenshot you post is the wallpaper.
• Your AI can make them. A built-in MCP server lets Claude, Cursor or any MCP client write wallpapers, see each attempt and set the one you like.
• Windows and Linux. A Windows app with an installer (behind your desktop icons, every monitor, tray icon, starts with Windows). On Linux, Wayland desktops with layer-shell (Hyprland, KDE Plasma, Sway, niri, COSMIC, river, Wayfire, labwc). Exports for Wallpaper Engine, Lively and Plash (macOS); videos and GIFs for everything else.

Install

Windows 10 and 11: download asciipaper-setup-….exe from Releases and run it. No administrator rights and nothing else to install (it uses .NET Framework and WebView2, which come with Windows). The installer isn't code-signed yet, so Windows may say it "protected your PC": choose More info → Run anyway. asciipaper then lives in the tray and starts with Windows.

Android 8 and up (live wallpaper): download asciipaper-….apk from Releases on your phone and open it (allow installing from your browser when asked). Released APKs may predate the shared Studio. The development build opens the common editor with all 11 scenes, custom projects and imported images, GIFs and videos. Pick a wallpaper, customize it and tap Set wallpaper to open Android's system picker. It reacts to touch and stops drawing when hidden.

Portable projects: save an editable .asciipaper.json file containing the shader, appearance and media, then import it on another platform. Windows, Android, Apple and the browser share the Studio; Linux's GTK Studio and CLI use the same specs. See shared runtime and builds and the platform status for verification and remaining differences.

macOS 14+ (preview): download asciipaper-macos-….zip from Releases, unzip, and move it to Applications. It isn't notarized yet, so the first time open System Settings, Privacy and Security, and choose Open Anyway. Or, without installing anything: make or pick a wallpaper on Linux or Windows (or grab one people share), export it (asciipaper export NAME, or Export in the Studio), unzip, and open index.html in the free Plash app: it stays live and interactive. Prefer a plain video wallpaper? asciipaper render NAME wallpaper.mp4.

Apple development apps: apple/project.yml defines native macOS and iPhone/iPad hosts for the common Studio. The macOS target includes a desktop wallpaper host. The iOS target edits, previews and exports; iOS does not support a third-party continuous interactive home-screen wallpaper. These are development targets, not signed App Store releases.

Arch Linux (a native package, built from the PKGBUILD here):

git clone https://github.com/cYoren/asciipaper && cd asciipaper/packaging/aur && makepkg -si
systemctl --user enable --now asciipaper.service

From source (Arch, Fedora, Debian/Ubuntu; installs into ~/.local):

git clone https://github.com/cYoren/asciipaper && cd asciipaper && ./install.sh

Packagers: make && make install PREFIX=/usr DESTDIR=…. Runtime: Python 3 with PyGObject, GTK 4, libadwaita, gtk4-layer-shell, WebKitGTK 6.0 (for HTML wallpapers), and optionally ffmpeg (porting and recording). The engine needs wayland, EGL/GLES 2 and pango, and wayland-protocols to build.

Use

Open asciipaper from your launcher (or asciipaper --studio):

Click a wallpaper to put it on your desktop. Use + or drag a file onto the window to port a picture, GIF or video. The Look panel changes the selected port live. Or from a terminal:

asciipaper list                        # everything in your library
asciipaper set matrix                  # choose (and keep) a wallpaper
asciipaper import ~/Videos/rain.mp4    # port a picture, GIF or video…
asciipaper import https://x.com/…/status/…   # …or a link, or a post on X
asciipaper create aurora               # start your own shader wallpaper
asciipaper export aurora               # ZIP for Windows and macOS
asciipaper render aurora aurora.mp4    # record a video or GIF
asciipaper render aurora aurora.png --size 7680x4320   # or an 8K still

Styles, effects and recipes

Any shader or ported wallpaper takes a whole new look in one command (or from the Studio's Style menu):

asciipaper styles                      # every look, shape, palette, dither, effect and warp
asciipaper look rain lego              # LEGO bricks; also pixel, mosaic, voxel, led, disco, dots, halftone, cmyk…
asciipaper look rain gameboy effects.crt=0.5 warp=kaleidoscope
asciipaper look donut palette=pico8 dither=bayer8 shape=pixel
asciipaper text "HELLO"                # big text as a wallpaper; style it like any other

• 60 styles: character looks (classic, blocks, braille, katakana Matrix code…), grid looks (pixel art, mosaic, LEGO, voxel cubes, LED matrix, disco tiles, halftone and CMYK print, crosses, diamonds, lines, hatching), retro palettes (Game Boy, C64, PICO-8, NES, CGA), print (risograph, cyanotype, sepia, noir) signal looks (CRT, VHS tape, glitch, lofi, cyberpunk, vaporwave, neon, anaglyph, amber, night vision, x-ray), hand-made looks (maze, hex tiles, crosshatch, cross-stitch, stipple) and photo looks (film, miniature, melt, relief, poster, mirror).
• Shapes draw each cell as a crisp vector shape instead of a glyph, at any size.
• 21 character ramps, 20 palettes (or your own up to 16 colours) and 11 ordered dithers (Bayer 2 to 16, halftone, radial, line and noise patterns), stable on moving pictures. Error-diffusion names (floyd, atkinson…) map to blue noise, because diffusion boils when the picture moves.
• Post effects you can stack: vignette, scanlines, CRT curvature, RGB split, bloom, film grain, glitch, dust, flicker, saturation and hue.
• Warps for ported media, all slowly animated: twirl, spherize/pinch, ripple, zigzag, polar, kaleidoscope, shear.

A look travels as one line: asciipaper recipe NAME prints an asciipaper:v1: code (a shader wallpaper's code rides along). asciipaper look NAME CODE applies a look and asciipaper import CODE rebuilds a shared shader wallpaper. Every PNG from asciipaper render carries its recipe, so a screenshot you post is also the wallpaper: asciipaper import shot.png or asciipaper look NAME shot.png.

Let your AI agent design wallpapers

asciipaper is also an MCP server. Hook it up and ask Claude, Cursor or any MCP client for a look in plain words ("a slow aurora in teal", "port this video, make it greener"). The agent writes the shader, sees a snapshot of every attempt (shader errors come back to it too), and puts the one you like on your desktop.

claude mcp add --scope user asciipaper -- asciipaper mcp        # Claude Code

Anywhere else, add a stdio server with the command asciipaper mcp. Tools: list_wallpapers, list_styles, get_wallpaper, write_wallpaper (shaders, styles, any look field, recipes), snapshot, set_wallpaper, import_media, text_wallpaper, encode_recipe, decode_recipe, render, export_project, import_project. Everything runs on your machine: no account, no upload, no cost per render. The Linux stdio server is listed in Glama's MCP directory.

Port anything

asciipaper import accepts a file, a direct link, or a post on X or Twitter (through the public fxtwitter API). It decodes the media once with ffmpeg into small frames the engine plays in a loop, and writes a wallpaper spec, ~/.local/share/asciipaper/user-wallpapers/NAME.json, with a starting look measured from the media:

• stretches its brightness to use every character;
• takes a tint and a dark background from its average colour;
• inverts paper-like pictures (sketches, line art, text), so the drawing gets the dense characters.

Everything the Studio's Look panel changes lives in that file, so you can also edit it by hand while it runs.

Add a wallpaper to asciipaper

Built-in wallpapers are just files. Put NAME.json and NAME.glsl (the spec format below) in wallpapers/specs/ and it appears in both apps, on Windows and Linux, and in exports: no code to change. Add a thumbnail with native/asciipaper-engine --spec wallpapers/specs/NAME.json --lib wallpapers/lib --snapshot wallpapers/thumbnails/NAME.jpg --size 960x540 --seconds 3 and open a pull request. Customizing a built-in in the apps makes your own copy, so the originals stay as shipped.

Make your own

A wallpaper can be a shader spec: a JSON file plus a GLSL function that runs once per character. asciipaper-engine runs it natively; the same files run in a browser, so they export to Windows and macOS unchanged.

asciipaper create aurora     # makes aurora.json + aurora.glsl in ~/.local/share/as