faq
answers about importing, converting, and exporting your media.
getting started
what is export.textmode.art?
a browser-based studio that converts an image, animated gif, or video into textmode art. adjust the result, then download it or copy a supported format.
how is export different from create.textmode.art?
create.textmode.art is an editor for drawing textmode artwork from scratch with glyphs, layers, and animation. export.textmode.art converts existing media into textmode art and exports the result as a download.
does my media leave my browser?
local media is processed in your browser and is not uploaded by the app. a direct media link is fetched from its source host. loading a lospec palette also makes a network request.
what can i convert?
- images: PNG, JPEG, webp, AVIF, and more
- animated GIFs and video: MP4 and webm
- direct HTTPS media links to supported files
what is the demo video that loads on startup?
a small bundled clip that shows the conversion in motion. it is replaceable like any other media.
importing media
how do i load media?
- choose a file with the file picker
- drop a file onto the preview
- paste media from the clipboard
- paste or drop a direct media URL from another tab
why won't my link import?
the studio needs a direct link to a supported media file over HTTPS. links that open a web page, mixed-content URLs, oversized sources, or sources that refuse the browser request will be rejected with a specific reason.
- only HTTPS direct media URLs are imported
- remote sources are capped at 64 MiB with a 30 second limit
- when a remote import fails, the previous session stays available
why are animated webp and animated png rejected?
animated webp and animated png are not supported yet. use the GIF, MP4, or webm rendition of the same media instead.
why did a static snapshot load instead of the animation?
when the clipboard only carries a static image snapshot of an animated source, the studio loads it as a still and explicitly says so, rather than pretending the animation survived.
are there size limits?
- image, video, and GIF sources are limited to 4096×4096 pixels
- animated GIFs are capped at 600 parsed frames
- direct remote imports are capped at 64 MiB
shaping the result
how do i change the level of detail?
adjust font size in settings. smaller characters create more cells and can preserve more detail; larger characters create a coarser image. try a different conversion method, font, or glyph set to change how the image is interpreted.
can i use my own font or characters?
choose a bundled font or upload a ttf, otf, or woff font from the font picker. local fonts are limited to 12 mb. edit the glyph set or choose a preset to control the characters available for conversion.
how do i control the colors?
set character color and cell color to sampled or fixed in settings. use the palette controls to limit colors, edit swatches, or load a .hex file or a lospec palette.
how do i crop or reposition the source?
in composition, set the output dimensions and choose contain, cover, or stretch. contain fits the source inside the composition; cover fills it and may crop the edges; stretch changes its proportions. use zoom, position, and rotation to refine contain or cover. changing fit resets zoom and position.
does zooming the workspace change my export?
no. workspace zoom and pan only change your view of the preview. use the composition controls to change the framing or output dimensions.
how do post effects work?
enable and adjust effects in the post fx section. drag effects to change their order. effects change the rendered image; a textmode document stores the underlying cells and does not include post effects.
where can i find keyboard shortcuts?
open the command palette with the search button or cmd+k on mac and ctrl+k on other platforms. it lists available commands and their shortcuts. shortcuts depend on the current source and focus.
conversion & export
how does the conversion work?
the renderer samples your media onto a glyph grid, choosing a glyph, glyph color, and cell color for every cell from the active font, colors, and palette settings. framing, cell size, and rotation shape the final composition.
what formats can i export?
- still: PNG, JPEG, webp
- structured: SVG, TXT, Textmode document (JSON)
- motion: GIF, MP4, webm
- frame sequences: ZIP archives containing PNG, JPEG, WebP, SVG, or TXT frames; JSON sequences use a single Textmode document
what does a Textmode document contain?
a textmode document uses version 4.0.0 with a frames array and is editable JSON for create.textmode.art and other compatible tools. it captures one or more frames: characters, font identity, foreground and background colors, flips, and rotation.
post-effects are not included. create.textmode.art supports grids up to 128×128 cells and checks fonts and features during import; larger exports remain valid for consumers that support larger grids.
which export format should i choose?
- png, jpeg, or webp: a rendered image of the current frame.
- svg: vector glyphs and optional cell backgrounds; txt: characters without colors.
- textmode document (json): editable cell data for compatible tools.
- gif, mp4, or webm: an animated export of the selected range.
can i copy the result to the clipboard?
use the copy button next to export for a current-frame png, svg, txt, or textmode document when your browser supports clipboard access. svg, txt, and json are copied as text. other formats and frame sequences must be downloaded.
why is export unavailable?
check the message in the export panel. you may need to add a source, enter a filename, choose a valid range, reduce the output dimensions, or select a format supported by your browser. mp4 also requires even output dimensions.
what does output scale change?
output scale changes the pixel dimensions of supported rendered exports relative to the composition size. larger output can take more time and memory. it does not add more characters to the grid; adjust font size for that.
what is the export range?
motion exports and frame sequences use the range from the in-point up to, but not including, the out-point. set these points in the transport to select the section to export.
what is a ZIP frame sequence?
on a video or animated GIF, choose a static format and set capture to frame sequence. the studio downloads a ZIP with a manifest and one-based, six-digit frame files. JSON sequences download as one Textmode document.
the selected in/out range and source-aware cadence determine the frame count. large sequences are built in browser memory, so shorten the range, lower the output scale, or choose a more compact format if the browser runs out of memory.
why does my exported GIF move differently than the source?
for an animated gif source, exports use the selected source frames and an effective uniform frame rate over the selected duration. uneven source frame timing can therefore look different. video exports use the source frame rate when available, up to 60 fps; otherwise they use 30 fps. for gif export from video, choose a frame rate under advanced in the export panel.
what happens when a motion codec is unavailable?
still and structured formats always remain available. if mp4 or webm is blocked in your browser, export the same range as a GIF or a still instead.
troubleshooting
why won't my browser open videos?
video input requires WebCodecs so the studio can decode exact timestamped samples. use an up-to-date browser with WebCodecs support; the studio does not fall back to approximate browser seeking.
why won't playback start?
your browser may block automatic playback until you interact with the page. press play in the transport to start playback.
why is my imported source a still instead of an animation?
the source is a static image, a one-frame GIF, or a clipboard snapshot of an animated source. load an animated GIF or video file to work with motion.
why did the renderer fail or the canvas go blank?
the graphics context can be lost under memory pressure. try reloading the page, closing other graphics-heavy tabs, or using a smaller source or composition.
how do i start over with the default configuration?
use the reset settings control at the top of the settings panel to restore defaults. the selected font is kept. settings are saved in browser storage, so reloading does not reset them.
where should i report a bug or missing answer?
join our discord server to report a bug, suggest a missing answer, share an idea, or ask a question.
discord server — bug reports, questions, and ideas.