Turn images into artwork made from dots, flowing curves, scattered shapes, cells, and mazes.
Open an image, explore a Pattern, and make it your own. Toniator is a native desktop app with independent color channels, a visual Pattern Wizard, and PNG or editable SVG output. It is free software under GPL-3.0-only.
The actual Toniator 0.4.5 editor. Source for the artwork above:
The portrait source was created with AI for these demonstrations. Every pattern effect below is rendered by Toniator; screenshots are captured from the real app. Click any image to inspect its full size.
Download the 0.4.7 Linux prerelease from GitHub Releases. Choose an AppImage or Flatpak:
# AppImage
chmod +x Toniator-0.4.7-x86_64.AppImage
./Toniator-0.4.7-x86_64.AppImage
# Or Flatpak
flatpak install --user ./Toniator-0.4.7-x86_64.flatpak
flatpak run io.github.ricperry.ToniatorInstallation, upgrades, and Windows · Build from source · Release notes
Version 0.4.7 adds optional Fast preview, a clearer native interface and keyboard help, and bounded CPU responsiveness improvements. Each window starts in Accurate CPU mode; Fast is approximate and falls back to CPU when needed. Exports retain their existing CPU rendering. The project format remains schema 19, shared with 0.4.6. Older projects are current-only: the gallery and editor screenshots below retain their 0.4.5 provenance, and their older projects require that release. Open the source artwork in 0.4.7 to create a new project. See format and Preset details.
- Choose Start New Project in the welcome window and open an image. Try the included raster or vector artwork. In the editor, New starts an empty document; Open artwork… adds your image.
- Pick a Model: RGB for colored light on black, CMYK for overlapping ink colors on white, or Source color + alpha to paint shapes with the image's own colors and transparency.
- Click Change… in Pattern Recipe. Select a gallery card and choose Apply Pattern, or Customize to explore how it is constructed.
- Start with All channels. Adjust Feature size: smaller values add finer detail; larger values emphasize the pattern. Try Rotation and offsets, then select an individual channel to give it a different arrangement.
- Use Preview / Source to compare with the original. Zoom in to inspect details, drag to pan when zoomed beyond Fit, and choose Fit to see it all.
- Open Main Menu → File → Save to keep an editable
.toniatorproject, including its source artwork. Choose Export image… for PNG or SVG.
A quick starting point: after opening your image, choose New options → Select preset… to try a complete built-in look such as Magazine CMYK, Skinny Curve, or Controlled Splatter CMYK.
The gallery supplies a starting point; the Wizard exposes its construction. Choose Guides, Scatter, or Spiral curve, adjust the family options, choose what it draws, and review before applying. Back lets you experiment; Apply Pattern changes the document in one undoable step.
| Choose a Pattern | Shape its distribution |
|---|---|
![]() |
![]() |
The Wizard studies every Pattern against the same built-in black-to-white source shown here, so its small preview is easy to compare across Patterns. Your portrait remains behind the dialog.
For scattered points, try Random, Poisson disk, Jittered cells, or Clustered. Change the variation number for another repeatable arrangement; use Point density to follow the artwork, Keep points apart for separation, and Relax points (Lloyd) to smooth the distribution. These control where points live; drawing and Advanced settings control what appears at those points.
These are 20 full-detail PNG exports from Toniator 0.4.5, with no image editing or pixel upscaling. The files are 2048×2048, 1800×1240, or 2508×2508; the small images here link to the original exports. Each group shows its source once. Open the editable projects, settings, and reproduction guide.
Source — original painted portrait, 1254×1254:
Source-colored marks retain the painting's palette. RGB screens and CMYK waves turn the same image into bolder graphic textures.
| Source color · Poisson marks | Curve Motif · repeated custom curve | Clustered Connections |
|---|---|---|
![]() |
![]() |
![]() |
| One Guide Lines | Grid Voronoi | Three-Guide Maze |
![]() |
![]() |
![]() |
| CMYK custom waves | ||
![]() |
Source — included raster artwork, 1024×1024:
| Round Spiral Line | Round Spiral Marks | Square Spiral |
|---|---|---|
![]() |
![]() |
![]() |
| Poisson Disk Marks | Source-Weighted Voronoi | Two-Guide Maze |
![]() |
![]() |
![]() |
| Fine CMYK waves | ||
![]() |
Source — included SVG artwork, 900×620:
| Custom curved guides | Magazine CMYK dots | Triagrid Diamond Marks |
|---|---|---|
![]() |
![]() |
![]() |
| Three-Guide Cells | Two-Guide Cells | Triagrid Spanning Tree |
![]() |
![]() |
![]() |
Each channel can have its own construction and transform. This example reuses the SVG source displayed above, combining straight lines, scattered circles, and diamonds. Select a named channel before changing its Pattern or offsets.
| Mixed RGB artwork · 1800×1240 | G channel selected in the real editor |
|---|---|
![]() |
![]() |
| Channel | Pattern | Feature size | Rotation | X / Y offset |
|---|---|---|---|---|
| R | One Guide Lines | 1.5 | 15° | +12 / −8 |
| G | Poisson Disk Marks | 0.95 | −10° | −16 / +10 |
| B | Triagrid Diamond Marks | 1.25 | 30° | +8 / +18 |
Open this editable project or see the exact channel settings.
Change one channel at a time. Select R/G/B or C/M/Y/K to vary its Pattern, rotation, spacing, paint, or response. Return to All for shared edits. Advanced Settings… separates Fill response (how much is drawn) from Source weighting (where artwork-dependent points gather).
Save the right thing. A .toniator project holds artwork and editable state.
A personal Pattern saves a reusable construction from the Wizard.
A Document Preset saves the whole channel/design configuration without source
artwork: use New options → Save preset, then Load preset… on another
image. Loading a Document Preset keeps your current artwork and canvas.
Compare before exporting. The Source view shows the original in the same canvas framing; it does not alter the design. Here it displays the SVG source used by the vector gallery above:
Use Main Menu → Export image…, choose PNG or SVG and a destination. For PNG, select background, antialiasing, and 1× native, 2×, 4×, 8×, or Custom size. Export resolution is independent of preview zoom. SVG preserves editable vector geometry and a transparent background.
PNG options for the custom curved-guides result in the vector gallery; its original SVG source is displayed above.
Source color + alpha retains source transparency and leaves gaps between marks. Here the same portrait has an AI-extracted transparent cut-out as its source; Toniator creates the open Poisson-disk marks.
| Transparent source · 1254×1254 | Native transparent PNG · 2000×2000 |
|---|---|
![]() |
![]() |
For DTG/DTF preparation, enable Print preparation → Prepare for garment printing in PNG options. Set the physical size and DPI, then inspect alpha and optional small-mark, narrow-feature, and gap corrections at a useful zoom. The garment color below is preview-only; the exported PNG retains transparency.
Both close-ups below use the same 2000×2000 target, 200% zoom, and pan. These are native preview-region captures; click for the complete app screenshot.
| Ordinary antialiased alpha | Binary alpha + optional corrections |
|---|---|
![]() |
![]() |
This example uses 200×200 mm at 254 DPI, then 4 px minimum feature width, 3 px isolated-mark removal, and 2 px gap fill. These are illustrative settings for this artwork; choose thresholds for your printing process. Preparation thresholds alpha at 128, then applies the enabled corrections.
Ordinary RGBA PNG · Binary alpha only · Prepared RGBA PNG · Editable project · Settings and pixel checks
Author Start and End, choose interpolation and timing, then use Export video… for a PNG sequence, lossless FFV1/Matroska, or AV1/WebM. Still artwork, videos, animated JPEG XL, and imported image sequences can supply the source. Animation walkthrough.
Using the original portrait in Portrait studies, this three-second study moves Feature size from approximately 1.538 to 0.625 and Rotation from 0° to 60°. Toniator renders all intermediate frames with smooth-in/out interpolation.
Native 1254×1254 video · Editable animation project · Source
The mixed-channel SVG artwork above keeps its three Patterns and Feature sizes fixed. Only each channel's Rotation and X/Y offsets animate, producing independent motion through the image.
Native 900×620 video · Editable animation project · Source · Channel endpoints and reproduction
Both native exports contain 48 frames at 16 fps. The inline GIFs are 720-pixel-wide sharing derivatives: 24 sampled frames at approximately 8 fps, with palette conversion. They contain no invented intermediate frames.
Use Main Menu → Help → Keyboard Shortcuts (Ctrl+?) for local help. F10 opens Main Menu, Ctrl+, toggles Settings, and F6 cycles the Canvas and Settings. Ctrl+0 fits the artwork; Ctrl++ and Ctrl+- zoom. Standard document shortcuts include Ctrl+N/O/S, Ctrl+Shift+S, Ctrl+E, Ctrl+W/Q, Ctrl+Z and Ctrl+Shift+Z/Ctrl+Y. Native text fields retain text editing and history.
Interface conventions · Accessibility support and known limits
Detailed usage guide · Example projects and exact settings · Command-line rendering · Known issues · Package guide
Toniator is prerelease software; keep original artwork and important projects.
Build from source. Developers can start with the architecture and normative Addendum. The GUI and headless CLI share the same evaluation and rendering core.
The optional Fast preview switch appears after Zoom/Fit; each window still starts in Accurate mode. Fast uses approximate GPU rendering for supported artwork and falls back to the CPU otherwise. Exports remain CPU rendered. See preview modes and measurements and limits. Fast requires a supported Vulkan adapter/driver. See the release notes for its eligibility and accuracy limits.
Created by Richard Perry. Free software under GPL-3.0-only, without warranty. Demonstration source artwork above is identified separately.
If Toniator is useful to you, an optional Ko-fi tip supports development. Artwork and design products are available from Silent But Digital Designs.



































