dfd51a3cdc #778: land the picture-probe and MCP cutovers (#6955, #6956) on main (#6960)
* #778: take craft-libs integration/wordcraft-778 at beeea924

Every craft-libs git dependency (workspace, ui-egui, wordcraft, wordcraft-web,
krilla patch) moves from 453b0da782 to beeea92451 (craft-libs main 0649a07aa
plus open PRs #2061-#2064). Cargo.lock: only craft-libs sources move, plus
windows-sys edge changes inside craft-libs crates; no crates.io versions change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* #778: docx stacking-order test follows the shared reader's one-more z

craft-libs 5f453efa9 (craft-docx: a relativeHeight of 0 stays the lowest
stacking order) reads Float::z as one more than the file's relativeHeight and
writes stored orders one less, so a file's 0 is no longer "none". The test
expected the old values; relative order and the round trip are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* #778: take craft-libs integration/wordcraft-778 at 24a15211

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* deps: pin craft-libs to the merged shared cutover prerequisites

* #778: pin craft-libs main at 93dac78c (with #2061-#2064)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* #778: picture probes use craft-image-codecs (DIB wrapping, JPEG budget, PNG/WebP) (#6955)

* #778: picture: wrap clipboard DIBs with craft-image-codecs' bmp_probe

probe_dib's local dib_to_bmp and dib_layout are replaced by
craft_image_codecs::bmp_probe::{dib_to_bmp, dib_layout}. The shared copies are
the same code; the only change is that they reserve their output fallibly. A
failed reservation in dib_to_bmp (the BMP's bytes can't be allocated) is
Refusal::TooLarge with the size the DIB header declares, the refusal a picture
too large to hold already gets; dib_layout leaves the DIB unchanged then.

The local dib_to_bmp name stays as a thin wrapper returning Result<_, Refusal>.
The old code is kept in the tests as an oracle: wrapping and layout are
byte-equal on thousands of crafted DIBs (core, info, V4, V5 headers, bit
fields, alpha with BI_RGB, every truncation), and probe_dib agrees.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* #778: picture: budget JPEG coefficients with craft-image-codecs

probe's JPEG held-coefficient estimate (jpeg_coefficients, frame_coefficients,
worst_coefficients) is replaced by craft_image_codecs::jpeg_worst_case_coefficients,
which returns the larger of that same estimate and the shared held_coefficients.
So the charge can only grow, never shrink.

It grows for: a SOF0/SOF1 8-bit first frame whose first scan has fewer
components than the frame (the decoder holds the coefficients until the other
scans); and a first-frame SOF2 with sampling factors above 4 (the old rule
clamped them to 4). A real baseline JPEG with all components in its first scan
is charged nothing, as before. With the 512 MiB budget, a 4:4:4 non-interleaved
baseline JPEG is now refused from about 59.6 Mpx instead of 67 Mpx; 4:2:0 and
4:2:2 stay under the RGBA8 conversion and are unchanged.

The old code is kept in the tests as an oracle: the new charge is never less
(crafted headers, every prefix, random damage), equal where the shared rule adds
nothing, and one test pins a case where it grows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* #778: picture: read PNG and WebP probes with craft-image-codecs

The local png_chunks header read is replaced by
craft_image_codecs::png_probe::pixel_model, and the VP8X alpha check in probe
by webp_probe::has_alpha (an error reads as no alpha, as non-RIFF input did).

PNG: for every valid colour type and bit depth, with and without tRNS and an
iCCP chunk, the size, bytes a pixel and alpha are what the old read gave
(PixelModel::bytes_per_pixel is channels * 2 for 16 bits, else channels, with a
palette as RGB and tRNS adding a channel to grey, RGB and palette). pixel_model
is stricter, so these are now refused (probe: Refusal::Broken, dimensions:
None) where the old read measured them: an invalid colour type and bit depth
pair, a zero or past-i32::MAX side, and more than 65,536 chunks before the
image data. None is a valid PNG.

WebP: a bare lossless (VP8L) picture whose header sets alpha_is_used now reports
alpha; the old rule only knew the VP8X flag.

The old PNG read and WebP rule are kept in the tests as oracles.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* #778: picture tests follow craft-image-codecs' DIB fixes

The shared dib_to_bmp no longer adds 12 appended mask bytes to the pixel
offset of 52/56-byte BI_BITFIELDS headers, and dib_layout treats the bytes
after the header as a mask copy only when the payload is longer than the
pixel rows need. The differential test excludes exactly those inputs by
named predicate, asserts the new output for them, and stays byte-equal
elsewhere.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* #778: dib_header_dims uses the shared fallible dib_to_bmp

Calls the shared probe directly so a failed allocation cannot recurse through the refusal wrapper.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* #778: WordCraft's MCP stdio server runs on craft-mcp-server (#6956)

The JSON-RPC framing, bounded line reading, initialize, ping, tools/* and
resources/* now come from craft_mcp_server::Server; WordCraft keeps its tools,
resources, instructions and backends. The old server.rs stays as a test-only
oracle for a differential test. click/key schemas list every argument the app
accepts, since the shared check refuses unlisted ones.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Dylan M. Taylor <dylan@dylanmtaylor.com>
2026-11-17 22:19:16 +01:00
2026-10-26 14:13:06 -06:00

ArtCraft

WordCraft icon: a document page and pen on a blue tile

WordCraft

Writing and document design; an open-source, modern word processor, built in pure Rust.

A fast, open-source word processor with a familiar workflow: the ribbon, styles, tables, track changes, references and mail merge. It reads and writes .docx, runs natively on macOS, Windows, Linux and BSD, and in the browser via WebAssembly.
By the ArtCraft team.

Written in Rust Runs on macOS, Windows, Linux, BSD and the web License: MIT OR Apache-2.0 Agent-drivable over MCP
Scanned by SonarCloud Reviewed by CodeRabbit

Join the ArtCraft community on Discord

WordCraft on getartcraft.com · ArtCraft · All Crafting Apps


WordCraft with the Home tab of the ribbon open over a two-page document titled The Open Studio Handbook. The Navigation pane on the left lists the document's headings, the Styles gallery shows live previews of Normal, Heading 1, Title and Subtitle, and a word in the first paragraph is selected.
The Open Studio Handbook, WordCraft's built-in sample: the ribbon, live Styles gallery, rulers and the Navigation pane.

Note

ArtCraft is a community of artists from all walks of life. Painters, photographers, filmmakers, illustrators, designers, animators, hobbyists, and people who picked up a pencil last week. If you make things, you're one of us. Come say hi on Discord.

A tour · Why WordCraft · What works today · Quick start · For agents · Architecture · Roadmap · Downloads · The Crafting Apps · License and credits

A tour

Every screenshot below is WordCraft itself, rendered offscreen by its own UI test harness (cargo run -p wordcraft-ui-egui --example ui_shot).

The Review tab with Track Changes on: the word forty is inserted in magenta and thirty struck through; three commented phrases are shaded and joined by dashed leader lines to comment balloons in a grey markup area to the right of the page

Review. Track changes, comment balloons in the margin, accept and reject, spelling and grammar as you type.

The References tab with two pages side by side: a table of contents with dotted leaders and page numbers on page one, and a styled table, numbered list and hyperlink on page two

References. Tables of contents, footnotes, citations in APA, MLA, Chicago or IEEE, index and captions.

The Design tab showing style-set previews; the document is set in a serif theme with plum headings underlined by thin rules and a pale diagonal DRAFT watermark behind the text

Design. Themes, style sets, paragraph spacing, watermarks, page colour and borders.

WordCraft in dark mode with the Insert tab open and formatting marks shown: pilcrows at paragraph ends and dots for spaces

Dark mode with formatting marks, and the Insert tab: tables, pictures, shapes, links, headers, footers, fields and symbols.

The Layout tab at 80% zoom: the first paragraph opens with a three-line drop cap E, a dark blue circle sits beside the second section with its paragraph wrapping around it and hyphenating art-ist at the line end, every line is numbered in the left margin and a thin blue border surrounds the page

Layout. Drop caps, text wrapping around pictures and shapes, automatic hyphenation, line numbers and page borders.

The File tab start page with a Good morning greeting, thumbnails of the Blank document, Studio handbook, Letter, Résumé and Report templates, and a list of recent documents

File. Start from a template, open recent documents, edit properties, export to PDF and other formats.

Why WordCraft

  • Familiar. Ribbon tabs, groups, shortcuts and behaviour: Enter continues a list, Tab demotes it, Ctrl/⌘+B bolds the word under the caret, the Styles gallery previews styles live, F4 repeats, F7 checks spelling, F8 extends the selection.
  • Your files. Opens and saves .docx (OOXML), and also .odt, .rtf, .html, .md, .tex (LaTeX), .txt; opens legacy 97-2003 .doc; exports PDF with real, selectable text, links and bookmarks.
  • Fast. Paragraph layout is cached, so typing in a 188-page document re-lays it out in about 1.4 ms; pages render on demand.
  • Everywhere. One Rust codebase for macOS, Windows, Linux, BSD and the web. No Electron, no Tauri: native egui on the GPU.
  • Built for agents. Every action is a command with an id. The same 422 commands drive the ribbon, keyboard shortcuts, the command search, a command-line tool, a JSON control channel and an MCP server.
  • Private. Spelling, grammar and everything else work offline.
  • Open. MIT OR Apache-2.0. Clean-room: built from public specifications and observation, with every asset original or openly licensed.

What works today

Area Highlights
Writing Fast typing with IME, smart quotes, AutoCorrect, list autoformat (* , 1. ), dashes; word, sentence, paragraph selection; drag-select; clipboard with formatting; undo/redo; find and replace with regex
Formatting Fonts, sizes, bold/italic/underline styles, strike, sub/superscript, caps, highlight, colours, character spacing, Format Painter, Change Case, Clear Formatting
Paragraphs Alignment, indents (draggable on the ruler), spacing, line spacing, tabs with leaders, borders, shading, keep with next, widow/orphan control
Styles Built-in style set, live gallery, Styles pane, create/modify/update styles, style sets, themes
Lists Bullets, numbering, multilevel, restart, set value, custom formats
Tables Insert by grid, merge/split, styles with banded rows, borders, shading, header rows repeated across pages, rows that split across pages, sort, formulas, text ↔ table
Pages Margins, orientation, size, columns, page/column/section breaks, headers and footers (first page, odd/even), page numbers, watermark, page borders, line numbers, vertical alignment, drop caps, automatic hyphenation
Objects Pictures (resize, crop, recolour, brightness/contrast, transparency, background removal, picture styles, rotate), shapes, text boxes, floating position with text wrapping (square, top and bottom, behind or in front of text)
References Table of contents, footnotes and endnotes, citations and bibliography (APA, MLA, Chicago, IEEE), captions, table of figures, cross-references, index, table of authorities
Review Spelling and grammar with suggestions (English and Polish, by each run's language), thesaurus, word count, comments in margin balloons or a pane, track changes, accept/reject, compare documents, restrict editing, accessibility checker, document inspector
Mailings Mail merge from CSV, merge fields, address block, greeting line, rules, preview, finish to a document; envelopes and labels
View Print layout, web layout, draft, read mode, focus, zoom, one/multiple pages, page width, Navigation pane, rulers, gridlines, dark mode; interface in English, 简体中文, 繁體中文, 日本語, Português (Brasil), Español, Українська, Српски / Srpski, Eesti, Türkçe, Русский, Italiano, Deutsch, Polski, Čeština, Magyar, Français, Български, Tiếng Việt, 한국어, Svenska, Hrvatski, Nederlands, Dansk, Română, العربية (mirrored) Slovenščina or Bosanski (follows the system language by default)
Files .docx read/write, legacy 97-2003 .doc import, PDF export, .odt, .rtf, .html, .md, .tex, .txt import/export, page images

The honest picture, area by area, is in ROADMAP.md, the parity assessment and the generated feature checklist.

Quick start

git clone https://github.com/storytold/wordcraft
cd wordcraft
cargo run --release -p wordcraft -- --sample        # the desktop app with the sample document
cargo run --release -p wordcraft -- report.docx     # open a document

The interface translations and the spelling and hyphenation data come from craft-i18n, an optional build input. To build with them, check it out at the commit in craft-i18n.rev and point CRAFT_I18N_DIR at it (an absolute path); without it WordCraft builds with an English interface, English spelling falls back to an installed Hunspell English or craft-proof's built-in word list, and only Bulgarian, Turkish and Russian hyphenate (by rule):

git clone https://github.com/storytold/craft-i18n ../craft-i18n
git -C ../craft-i18n checkout "$(cat craft-i18n.rev)"
CRAFT_I18N_DIR="$PWD/../craft-i18n" cargo run --release -p wordcraft -- --sample

Command line:

wordcraft-cli convert report.docx report.pdf        # docx, pdf, odt, rtf, html, md, tex, txt, png
wordcraft-cli convert report.docx report.pdf --strict   # exit 3, no file, if a character or picture would be left out
wordcraft-cli text report.docx                      # plain text
wordcraft-cli inspect report.docx                   # structure as JSON
wordcraft-cli run --template sample \
  --cmd 'select.text={"text":"Membership"}' --cmd format.bold --save out.docx
wordcraft-cli run --script job.json                 # the same from a file: commands, then save to docx and pdf

convert --strict (a .pdf or .png output only) and render --strict (a PNG of one page) refuse a silently incomplete render: they exit 3 and write nothing if the output would draw a character no font has (an empty box) or leave out a picture. Exit codes are 0 (written), 1 (unreadable input, usage error, or --strict with another output type, checked before the input is read) and 3 (strict refusal). On exit 3, stderr has one wordcraft-cli: strict: … line per kind, then one JSON line:

wordcraft-cli convert in.docx out.pdf --strict
# wordcraft-cli: strict: 1 character cannot be drawn: U+2D30 (×3)
# wordcraft-cli: strict: 1 picture(s) left out: word/media/image2.bin (header2.xml): unsupported format
# {"schema":1,"strict":"failed","missing_glyphs":[{"cp":"U+2D30","count":3}],"missing_pictures":[{"part":"word/media/image2.bin","source_part":"word/header2.xml","reason":"unsupported_format"}],"truncated":false,"total_missing_glyphs":1,"total_missing_pictures":1,"glyphs_truncated":false,"pictures_truncated":false}

The JSON line (schema 1, also what file.strictReport returns) has schema, strict ("passed" or "failed"), missing_glyphs (entries {"cp", "count"}, sorted by code point), missing_pictures (entries {"part", "source_part", "reason"}: the picture's part or target, the story part it sits in such as word/header2.xml, and a reason code; source_part is also background (the page picture), body, header, footer, footnote, endnote, comment or text box where the part name is not known (a document not opened from a DOCX), or a chunk path such as word/afchunk1.docx > word/header1.xml for a picture inside an embedded DOCX chunk), truncated, the two totals total_missing_glyphs and total_missing_pictures, and glyphs_truncated and pictures_truncated for each list. The reason codes are missing_part, external_target, link_only, undecodable and unsupported_format; the stderr lines use plain words for them. When a list is cut, the stderr line gives the total (300 characters cannot be drawn (first 256 listed)). Each list stops at 256 entries separately; truncated is true when either was cut, and the totals count every distinct character and picture found, those past the cap included. Only characters the output draws count (not hidden text, or deleted text without --markup), and a character a fallback font draws is fine. Text inside a WMF or EMF picture counts too, shaped in the font the picture names with no fallback. A Private Use Area character fails only if no installed font maps it. The result depends on the fonts installed on the host (see #5624 for a fixed font set). An external picture target is never fetched: it is reported, not loaded. Pictures dropped when a DOCX is opened (a missing part, an external target, or a link only picture with no embedded copy) are reported for DOCX input only. They have no page, so a PNG of any page is also refused for a missing or external picture anywhere in the document, unused headers included. render --strict checks only the page it writes (--page; --scale doesn't matter), prints nothing on stdout when it refuses, and reports the same way. The engine takes strict: true on file.save, file.saveAs, file.exportPdf and file.exportPng, and file.strictReport {markup?, page?} returns the report without writing.

Web: cd apps/wordcraft-web && trunk serve, then open http://127.0.0.1:8771/?sample.

For agents: CLI and MCP

WordCraft was designed to be driven by people and by AI agents.

claude mcp add wordcraft -- wordcraft-cli mcp                  # headless documents
# confine the agent to folders: wordcraft-cli mcp --automation-read-root DIR --automation-write-root DIR
wordcraft --control 7981 &                                     # or drive the running app…
claude mcp add wordcraft-app -- wordcraft-cli mcp --connect 127.0.0.1:7981

Tools include list_commands, execute, batch, type_text, select_text, inspect_document, render_page, save_document, and, with a running app, screenshot, click and key. Agents can check their work through inspect_document without screenshots. See docs/mcp.md and the control protocol. Macros record any sequence of commands and play it back (tools.recordMacro, tools.macros).

Logs

The desktop app writes its log records to standard error and to logs/wordcraft.log next to its preferences: on Linux $XDG_CONFIG_HOME/wordcraft/logs/ (by default ~/.config/wordcraft/logs/), on macOS ~/Library/Application Support/WordCraft/logs/, on Windows %APPDATA%\WordCraft\logs\. A start from a desktop menu or the Dock has no terminal, so this file is what to attach to a bug report: unreadable parts of a .docx, pictures or fonts a PDF export had to leave out and panics the command guard recovered from land there. Each launch moves the previous log to wordcraft.1.log (and that one to wordcraft.2.log), so the log of a run that crashed survives the next start; a log stops growing at 16 MiB. --version writes no file, and runs with WORDCRAFT_NO_PREFS (agents' test runs) log to standard error only. Document text is never logged; a panic message leaves out the text it quotes.

By default WordCraft's own crates log at info and everything else at warn. RUST_LOG replaces that with env_logger-style directives, for example RUST_LOG=debug, RUST_LOG=warn,wordcraft_docx=trace or RUST_LOG=info,wgpu_core=warn; a directive ending in * covers every target starting with it (wordcraft*=debug). The logger is apps/wordcraft/src/logging.rs.

Architecture

Layer Crate Job
L0 wordcraft-geom units and measurements
L1 wordcraft-doc, wordcraft-fonts, wordcraft-proof (craft-proof from craft-libs) document model and editing; fonts and shaping; spelling, grammar, hyphenation (data: craft-i18n language-data/, CRAFT_I18N_DIR)
L2 wordcraft-layout, wordcraft-docx, wordcraft-formats line breaking, pagination, tables, notes, hit testing; OOXML; ODT/RTF/HTML/Markdown/TXT
L3 wordcraft-render, wordcraft-pdf rasteriser (vello_cpu); PDF (craft-pdf, Krilla)
L4 wordcraft-engine session, undo, 422 commands, document feature catalog
L5 wordcraft-mcp MCP server
L6 wordcraft-ui-egui the word processor front end (swappable)
apps wordcraft, wordcraft-cli, wordcraft-web desktop, command line, browser

cargo xtask ci runs formatting, clippy, ~800 tests, the asset-attribution check, the layering check and the wasm build. Contributor and agent instructions: AGENTS.md.

Roadmap

WordCraft is in alpha. It has commands for 97% of the ribbon and menu features in its feature catalog (docs/parity-checklist.md) today; counting depth, file fidelity, stability and the rest, we estimate it is about 60% ready for real work, about 55% for a typical professional's weekly work and about 63% for everyday essentials. Beta needs testing against real-world .docx files, keeping charts and SmartArt through a round trip, closer pagination fidelity, a stability sweep and native printing. Details and estimates: ROADMAP.md and where we fall short.

Downloads

Download WordCraft from GitHub: the latest release has every build listed below, and all releases has earlier versions and their notes. <ver> in the file names is the version number, and SHA256SUMS.txt lists a checksum for every file.

Windows

Build Installer Portable
x64 (64-bit Intel/AMD) wordcraft-<ver>-windows-x64.msi wordcraft-<ver>-windows-x64-portable.zip
arm64 (Snapdragon and other ARM PCs) wordcraft-<ver>-windows-arm64.msi wordcraft-<ver>-windows-arm64-portable.zip
x86 (32-bit) wordcraft-<ver>-windows-x86.msi wordcraft-<ver>-windows-x86-portable.zip

The installer is one dual-scope package. By default it installs for your account only, into %LOCALAPPDATA%\Programs\ArtCraft\WordCraft, and needs no administrator rights; choosing "Everyone on this computer" on the first page installs into C:\Program Files\ArtCraft\WordCraft (Program Files (x86) for the 32-bit build) and asks for an administrator. Install only one copy: a copy for another scope is refused, so uninstall first to change who WordCraft is installed for. Installers and executables are code-signed.

If the app doesn't open on Windows: the desktop app initializes only DirectX 12 by default. Letting wgpu also create an OpenGL instance can crash some graphics drivers (AMD's atio6axx.dll) before the window appears, so the app would flash in Task Manager and quit. WGPU_BACKEND overrides the default for troubleshooting (for example dx12 or vulkan). In PowerShell, from the folder containing the executable:

$env:WGPU_BACKEND = "vulkan"
& .\wordcraft.exe
Remove-Item Env:WGPU_BACKEND                     # restore the default for later launches

An explicit gl override can bring the driver crash back on affected systems. The macOS, Linux and web backend defaults are unchanged.

The 32-bit build uses OpenGL even when a DirectX 12 graphics card is present. On 32-bit Windows, creating a DirectX 12 graphics pipeline fails immediately and the app exits before the window appears. WGPU_BACKEND=vulkan (or dx12) still overrides that.

If the app quits right after its window appears with "Parent device is lost" in the log: WordCraft compiles DirectX 12 shaders with FXC, the compiler built into Windows, so it needs no dxcompiler.dll/dxil.dll and ignores any copy another program put on PATH (#603). WGPU_DX12_COMPILER (fxc, dxc, auto) overrides this; with dxc, a matching dxcompiler.dll and dxil.dll must sit next to wordcraft.exe. WGPU_BACKEND = "vulkan" also avoids DirectX 12 altogether.

If the app is slow on an older Windows PC: when DirectX 12 finds no graphics card with a driver for it (for example Intel 4th-generation graphics on Windows 11), it only offers the built-in software renderer, which draws every frame on the processor. WordCraft normally uses OpenGL instead, without setting anything. If OpenGL has no usable adapter, it can use DirectX 12's WARP software adapter. The log file records the choice (lines starting with graphics:). WGPU_BACKEND still overrides it, e.g. $env:WGPU_BACKEND = "gl" or "dx12".

macOS

Build File Notes
App, universal (Apple silicon + Intel) wordcraft-<ver>-macos-universal.dmg Signed and notarized
Command-line tool, universal wordcraft-cli-<ver>-macos-universal.zip Signed and notarized

Linux

Format x86_64 aarch64 (ARM64) Notes
AppImage wordcraft-<ver>-linux-x86_64.AppImage wordcraft-<ver>-linux-aarch64.AppImage Runs anywhere; updates itself with AppImageUpdate (.zsync files)
Flatpak wordcraft-<ver>-linux-x86_64.flatpak wordcraft-<ver>-linux-aarch64.flatpak Sandboxed; flatpak install --user <file>
Debian/Ubuntu wordcraft-<ver>-linux-x86_64.deb wordcraft-<ver>-linux-aarch64.deb
Fedora/RHEL/openSUSE wordcraft-<ver>-linux-x86_64.rpm wordcraft-<ver>-linux-aarch64.rpm
Tarball wordcraft-<ver>-linux-x86_64.tar.gz wordcraft-<ver>-linux-aarch64.tar.gz Unpack anywhere

RISC-V (riscv64): wordcraft-<ver>-linux-riscv64.tar.gz, a tarball cross-compiled for glibc 2.39+ (Ubuntu 24.04, Debian 13 and newer).

Read Aloud (Review › Read Aloud) speaks through a speech program installed on the system: it tries espeak-ng, then espeak, and when neither is installed it talks to Speech Dispatcher. The .rpm package recommends espeak-ng; the .deb recommends espeak-ng or speech-dispatcher, so the package manager installs one of the two by default. With the AppImage or the tarball, install one yourself if neither is there (sudo apt install espeak-ng, sudo dnf install espeak-ng, sudo pacman -S espeak-ng). The Flatpak doesn't speak yet: it has no audio access and doesn't include espeak-ng, espeak or Speech Dispatcher.

Wayland: on a Wayland desktop the app runs through XWayland when it is available, because winit (the windowing library) supports dragging files into the window only on X11. To use the native Wayland backend instead (for example for sharper text with fractional scaling, at the cost of file drag-and-drop), choose File › Options › Advanced › Linux display server › Wayland; it applies the next time WordCraft starts, and X11 (XWayland) or Automatic switches back. The WORDCRAFT_WAYLAND environment variable overrides the setting: 1 for native Wayland, 0 for XWayland:

WORDCRAFT_WAYLAND=1 wordcraft

XWayland needs the X11 libraries, which the packages only recommend and the tarball doesn't install: libX11, libX11-xcb, libXcursor, libXi and libxkbcommon-x11 (on Debian and Ubuntu, libx11-6, libx11-xcb1, libxcursor1, libxi6 and libxkbcommon-x11-0). Without them the app opens on native Wayland, whatever the setting says, and logs which ones are missing.

Arch Linux (AUR). Community members maintain three AUR packages; the project doesn't publish to the AUR itself. Install one of them:

Package What it installs Choose it when
wordcraft-bin The release tarball above, prebuilt (x86_64, aarch64) You want the latest release without compiling (quickest)
wordcraft The latest release, built from source with cargo You prefer to build releases yourself
wordcraft-git The current main branch, built from source You want unreleased changes and accept an occasional broken build
For example yay -S wordcraft-bin or paru -S wordcraft-bin.

Community packages

These packages are maintained by community members, not by the WordCraft team.

On Gentoo, the ::snakebyte overlay packages the Linux release as app-office/wordcraft-bin (prebuilt) and app-office/wordcraft (built from source):

eselect repository add snakebyte git https://github.com/switch87/snakebyte-overlay.git
emaint sync -r snakebyte
echo 'app-office/wordcraft-bin ~amd64' >> /etc/portage/package.accept_keywords/wordcraft
emerge --ask app-office/wordcraft-bin

FreeBSD

Build File
x86_64 wordcraft-<ver>-freebsd-x86_64.tar.gz

Web (WebAssembly)

Build File Notes
Static site wordcraft-web-<ver>.zip Runs in a modern browser; host it on any static server

The Crafting Apps

WordCraft is one of the Crafting Apps: free, open-source creative tools from the ArtCraft team, each written from scratch in Rust and each able to stand on its own.

App What it's for Code Learn more
PhotoCraft Image editing: layers, masks, type and real PSD files GitHub Website
VectorCraft Vector illustration GitHub Website
FilmCraft Video editing, color and sound GitHub Website
LightCraft Photo library and raw development GitHub Website
PdfCraft Reading, organizing and protecting PDFs GitHub Website
EffectCraft Motion graphics and visual effects GitHub Website
DesignCraft Page layout and publishing GitHub Website
FigCraft Interface design and prototyping GitHub Website
WordCraft Word processing and documents GitHub Website
SoundCraft Audio recording and editing GitHub Website
DeckCraft Presentations and slide decks GitHub Website
CADCraft Computer-aided design GitHub Website
GridCraft Spreadsheets and data GitHub Website
TextureCraft 3D texture painting GitHub Website
Craft Anything See how any software works, then build your own GitHub Website
SolidCraft Parametric 3D CAD by Tangency Labs (community app) GitHub

And ArtCraft itself, our AI image and video studio for artists who want real control.


Join the ArtCraft community on Discord

Come make things with us

Our Discord is where artists of every kind hang out: people who paint, shoot, draw, cut film, set type, and people still figuring out what they like to make. Share what you're working on, ask for help, tell us what's broken, or tell us what you wish these tools could do. Whatever your medium and however long you've been at it, you're welcome here.

discord.gg/artcraft · getartcraft.com · The Crafting Apps · WordCraft

License and credits

WordCraft is dual-licensed under MIT or Apache-2.0, at your option. Copyright (c) 2026 ArtCraft Team and the WordCraft contributors. Required notices are in NOTICE.

Bundled fonts, icons, images and other assets keep their own open licenses; each one is listed with its author, source and license in ATTRIBUTION.md.

English spelling first tries a matching Hunspell dictionary from the Dictionaries folder. Otherwise it uses dialect-specific SCOWL 2026 dictionaries when built with language data; without it, spelling falls back to system Hunspell dictionaries or Grady Ward's public-domain Moby Hyphenator II word list. English hyphenation uses the Moby list and patterns trained from it. Polish spelling reads the Hunspell pl_PL dictionary installed on the system (not bundled), as do Russian, Portuguese, Czech, Italian, Croatian and Turkish spelling (how to install them: docs/spelling-dictionaries.md), and Polish hyphenation the TeX patterns by Hanna Kołodziejska, Bogusław Jackowski and Marek Ryćko (MIT option). The sample documents and templates are original text written for WordCraft.

The ArtCraft name, wordmark and logos in docs/brand/ are trademarks of the ArtCraft Team and are not covered by this license. They may be used only unmodified, and only as part of this repository and WordCraft, under docs/brand/LICENSE-brand.txt. Forks and modified versions must remove them.

ArtCraft
Made by the ArtCraft team and community.

S
Description
No description provided
Readme
178 MiB
0 Stars 1 Watchers 0 Forks
Languages
Rust 99.5%
PowerShell 0.3%
Shell 0.2%