Plottter is a free, open-source desktop application for generating pen-plotter-ready vector art from mathematical equations and raster images. It produces multi-layer SVG output (and HPGL/G-code) suitable for any pen plotter such as the AxiDraw, HP plotters, or CNC machines with a pen mount.
| Requirement | Version |
|---|---|
| Python | 3.12 or later |
| pip | 21.3+ (PEP 660 editable installs) |
| Operating system | Linux, macOS, Windows |
| Qt runtime (bundled via PyQt6) | Qt 6 |
| Optional: pyaxidraw | Latest (for direct AxiDraw USB control — see Export & Plotting) |
| Optional: quickjs | Any (enables the TurtleToy plugin — see Math Art Guide) |
On Linux you may also need:
libEGL.so.1 (part of Mesa or Chromium)
See the Troubleshooting guide if the app fails to start on a headless or minimal Linux installation.
# 1. Clone the repository
git clone https://github.com/pywkt/plottter.git
cd plottter
# 2. Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# 3. Install Plottter and all dependencies
pip install -e ".[dev]"- PyQt6 — GUI framework
- numpy — numerical computation
- opencv-python — image processing
- Pillow — image I/O
- shapely — 2D geometry
- scipy — spatial indexing and ODE integration
- svgwrite — SVG generation
- noise — Perlin noise for flow fields
Start Plottter from the command line:
python -m plottterOr use the installed entry point (after pip install -e .):
plottterThe application window appears with:
- Left panel — Mode selector and generator list
- Center — Interactive canvas (white paper on grey background)
- Right panel — Generator parameters and Generate button
- Bottom — Layer panel with controls
- Status bar — Canvas size, path count, and cursor coordinates
When the app opens, a default project with an A4 canvas and one empty layer is ready to use.
To start from a specific paper size:
- File › New (or
Ctrl+N) - Select a paper preset (A4, A3, Letter, etc.) or enter custom dimensions
- Set a margin (default 10 mm) — plotters cannot usually reach the paper edge
- Click OK
- In the left panel, confirm Math Art mode is selected
- Choose a generator from the dropdown, for example Parametric Curves
- Select a preset from the dropdown at the top of the right panel — try Lissajous
- Click Generate (or
Ctrl+G, orCtrl+Enter)
The canvas shows the generated paths. Zoom with the scroll wheel; pan by holding the middle mouse
button (or Ctrl + drag). See Canvas Navigation for the
full list of pan and zoom options.
- File › Export Current Layer (
Ctrl+E) or Export All Layers (Ctrl+Shift+E) - Choose SVG format
- Select an output file (or directory for batch export)
- Click Export
Open the resulting .svg file in Inkscape, your plotter software, or send it directly to the
plotter.
Plottter includes these built-in presets:
| Preset | Width × Height |
|---|---|
| A4 | 210 × 297 mm |
| A3 | 297 × 420 mm |
| A2 | 420 × 594 mm |
| Letter | 215.9 × 279.4 mm |
| Legal | 215.9 × 355.6 mm |
Select Custom in the new-project dialog to enter any dimensions in mm or inches.
The margin setting defines the safe drawing area inset from the paper edge. A margin of 10 mm is a safe default for most plotters. The canvas shows the margin as a dashed grey rectangle inside the solid paper border.
Projects are saved in Plottter's own .plottter format (JSON, gzip-compressed for large files):
- Save —
Ctrl+S(saves to current path, or prompts if new) - Save As —
Ctrl+Shift+S - Open —
Ctrl+O
The File › Recent Projects submenu lists your last 10 projects for quick access.
| Topic | Guide |
|---|---|
| Math generators (parametric, polar, L-systems, Voronoi/Delaunay, Penrose tiling, grids, text, 3D) | Math Art Guide |
| Convert a photo to line art (LIC, TAM, stipple, hatching, halftone, and more) | Image-to-Lines Guide |
| Work with layers and pen colors | Layers & Colors |
| Export SVG, HPGL, G-code, or Mural | Export & Plotting |
| Preview and simulate the plot | Preview & Simulation |
| Tips, workflows, and brush effects | Tips & Workflows |
| Fix common issues | Troubleshooting |