Repository navigation
Releases
Stylus 0.3.0
-
Public betas for macOS, Windows and Linux (2026-10-12), the way
Coupler ships: GitHub Actions builds the Windows installers (NSIS and
MSI) and the Linux .deb and .rpm on every version tag and publishes
them to the version's GitHub release (devbetween versions), and the
Mac release script now builds a universal app (Apple Silicon and
Intel), signed with the Developer ID, notarized and zipped for the
same release. ansiapps.com links the newest files. The app's binary is
nowstylus(it wasapp), and the selection buttons' tooltips show
Ctrl shortcuts off the Mac. -
Frames and layers in the document model (2026-09-30): every
document is now frames × layers instylus-core(src/frames.rs),
ready for Phase 3's timeline and Layers tab with no model or recovery
format change. Frames can be added (a copy or blank), deleted, moved
and given a hold time; layers added, deleted, shown and hidden, the
same in every frame; each change is one undo step, and undoing a
stroke on another frame shows that frame. Resize and the iCE switch
cover every frame. Saving writes the frame shown, merged, and the
save warning says so when there's more than one frame or layer. The
crash-recovery snapshot is now version 2 and keeps every frame and
layer (version 1 still opens). Fixed on the way: icy_engine skips
writes to hidden or locked layers, so the model writes past that for
undo, resize and the iCE switch, and drawing on a hidden or locked
layer is refused instead of leaving an empty undo step. -
View basics (2026-09-30): View → Fit Window shows the whole piece
at once, Grid (⌘') draws the cell lines, Preview (⇧⌘P) hides the
cursor, selection, grid and contrast marks to check a finished piece,
and Describe Cell (⇧⌘D) reads the cell at the cursor to screen
readers. The status bar names the font. -
Measuring the editor's hot path (2026-09-30):
stylus-core's
stroke_benchexample times a fast pencil drag in the core alone
(about 3 µs a move on the M1). Dev builds time each pencil move from
pointer to canvas and each IPC call, log them per stroke, and add
Help → Measure Drawing Speed (dev), a scripted drag at 400%. None of
it is in a release build. Measured on the M1: a fast drag at 400% is
drawn within 7 ms a move (every move inside a 120 Hz frame), so the
desktop editor stays on IPC. -
Editing begins (Phase 1) (2026-09-30): the Viewer tab is now the Art
workspace, where opened art can be edited and new art made.- New… (80×25, 80×50, 132×25, 160×25 or any size, iCE on or off).
- Type at a cursor (arrows, Home/End, Page Up/Down, Backspace, Delete;
Enter or Down on the last row adds a row), the Pencil (right-drag
erases), Pick (or Option-click), and painting characters and colors,
colors only or characters only. - Ten F-key character sets on F1–F10 and a clickable strip, a
256-character picker, 16 color swatches, a status bar. - Undo and redo by stroke (⌘Z, ⇧⌘Z).
- Save and Save As in ANSI, plain text, XBin, BIN, Artworx, iCE Draw
and TundraDraw, through icy_engine. The dialog lists what the format
would lose before saving, and won't save what it can't hold. SAUCE
title, author, group and comments are written in one fresh record,
keeping the file's date. Save asks the first time it would replace a
file; a replaced file is written beside it and moved over it. - Opening, New or closing the window with unsaved changes asks first.
-
The drawing tools and selection (2026-09-30): Eraser, Line,
Rectangle (outline or filled), Box (single or double lines), the
Half-block brush (half-cell pixels, right-drag in the background color),
and flood Fill join the Pencil. Shapes preview as the real art while
dragged and undo in one step. Select drags a rectangle (or Shift+arrows,
⌘A), and the selection can be cut, copied, pasted (opaque or
transparent, into any open document), moved by dragging, flipped (with
▌▐, ▀▄ and the box corners mirrored), filled and cleared. Single-letter
tool keys work while not typing; Esc leaves Type. -
Menu bar (2026-09-30): File, Edit, Draw, Select, Colors, View and
Help, drawn from one command registry that also runs every shortcut
and fills Help → Keyboard Shortcuts. Option plus a menu's letter opens
it, and arrows move through it. The Art and Make workspaces and the
gear sit at the bar's right; the editor's toolbar went into the menus
(zoom and the render settings in View, iCE in Colors, the Amiga fonts
in View for text files). The art's name, with • when unsaved, is in
the window title and the status bar. X swaps the colors. -
The macOS menu bar (2026-09-30) carries the same menus as the
in-window bar, from the same command registry: the same items greyed
out and ticked, ⌘ shortcuts shown, plus the app menu (About, Services,
Hide, Quit) and the Window menu. In a text field or dialog, ⌘C, ⌘V, ⌘Z
and ⌘A edit the text. Quit (⌘Q) now asks about unsaved changes, as
closing the window does. -
Recent files and crash recovery (2026-09-30): File → Open Recent
(a submenu in both menu bars, with Clear Menu) and a Recent list on the
empty screen hold the last ten files opened or saved; a file that's
gone comes off the list when it fails to open. Unsaved changes are
autosaved every 10 seconds to the app-data folder, never over the file,
in a lossless snapshot (icy_engine's IcyDraw format plus the file's own
SAUCE record, format and render settings). Saving, discarding or
closing removes it; after a crash Stylus offers the art back at launch
(and under File → Recover Unsaved Art…) with its changes unsaved and
the original file untouched. -
Export PNG (2026-09-30): File → Export PNG… (⇧⌘E) writes the art at
its own pixel size, in 8- or 9-px cells, optionally stretched to the
original screen's aspect, with a progress bar over the rows. It starts
from how the art is shown and leaves the view as it was. -
Contrast lint (2026-09-30): View → Check Contrast, on per
document, lists in a new Problems tab every text cell under 4.5:1 and
every graphic (symbols, shades, half blocks, line drawing) under 3:1
against its background, grouped by color pair with the ratio and cell
count, by the ANSIapps contrast rules. Failing cells are outlined on
the art; choosing a row outlines its cells and moves the cursor there.
Ratios use the colors the art shows (its palette, bold as bright,
24-bit as is) and are checked again after every edit. -
Amiga ASCII (2026-09-30): text files without SAUCE get a Font menu
with the Amiga fonts, remembered per file type. -
UTF-8 text files (2026-09-30) show their block characters (▀ ▄ █),
which came out blank before. -
Saving tested on real art (2026-09-30):
scripts/roundtrip-corpus.sh
saves every corpus file again and compares pixels. On 181 files: 353
saves identical, 9 differing only where the save warned. It found
icy_engine's color optimizer dropping look-alike rows from ANSI, so
saves are now cell-exact, and a TundraDraw writer bug, written up in
docs/upstream/icy_engine-tundra-initial-color.mdand sent upstream as
icy_tools#188. -
The "77 rows" 162-column file is explained: its SAUCE asks for the EGA
8×14 font, which Stylus uses and ansilove doesn't. -
Roadmap (2026-09-30):
docs/roadmap.mdconsolidates the two
ANSI-editor feature surveys with the design notes into a four-phase
rollout (open and draw, theme workshop, make and animate for 1.0,
everywhere and beyond), and lists the survey features Stylus won't
build and why. -
UI design (2026-09-30):
docs/ui-design.mdadapts the ANSI editor
UI survey to Stylus's phases and the ANSIapps theme: the Art, Make,
Theme and Lab workspaces, the F-key strip, one Problems list, and a
native macOS menu bar beside the in-window one. The roadmap moves the
command palette and custom shortcuts to Phase 3 and adds a
reference-image layer. -
In-development warning (2026-09-30): on first run, before any
window, a native dialog says Stylus is still in development. OK opens
the app and is remembered (a marker file in the app-data folder);
I'll Be Back. quits and asks again next launch. The main window is now
created only after that (src-tauri/src/first_run.rs, after
Diskette's). -
Image to ANSI (2026-09-30): a new tab. Drop an image on the window
(or choose one) and 36 open-source image-to-ANSI converters each turn
it into an 80-column.ANS, shown side by side, each labelled with its
project, repository, license and the settings used. Save one, or all
into a folder (existing files are never replaced).- The converters are Rust ports in
stylus-core/src/convert/, all
under licenses that allow closed-source commercial use: KOAN.ansi,
img2ansi (Wes Brown), libcaca, two png2ansis, ansify, ansir, CLImage,
TerminalImageViewer, viuer, catimg, terminal-image, two imgcats,
termpix, image-to-ansi, aimg, img2ansi (John McCabe, Jakob Westhoff),
ansipx, asciimatics, term-image, Rich Pixels, img2txt, img2ansi
(Bryan Matsuo), hiptext, ansize, ascii-image-converter, ASCII Magic,
img2ansi (Lukas Beranek), tapciify, image-to-ascii, img_to_txt,
chromatic, ANSI-art and ransid. Two carry a whole resizer:
ImageMagick's (magick.rs) and stb_image_resize2's (stbir.rs). - Every one matches its original cell for cell on the test images
except ansify (99.8%+, its k-d tree breaking ties its own way). The
survey, exclusions and results are in
docs/image-to-ansi-converters.md. - About lists every converter's and ported library's license in full.
- The converters are Rust ports in
-
icy_tools upgraded to
da0d287(2026-09-30), the TundraDraw fix
from icy_tools#188: black text before a TundraDraw file's first color
change no longer comes back light gray, so.TNDsaves are exact and
back in the round-trip tests. The only other change si...