vpype Tutorial for Beginners: Optimize Any Plot in 5 Minutes

vpype is the most useful free tool in pen plotting, and it’s also the one beginners skip because “command line” sounds intimidating. It isn’t. This vpype tutorial gets you optimizing real plots in about five minutes.

What vpype is for

Generative tools and vector editors produce SVGs that are fine for the screen but wasteful for a plotter — paths in a random order, with the pen lifting and crossing the page hundreds of unnecessary times. vpype fixes that. Its two headline jobs:

• linemerge — joins paths that share endpoints into single strokes (fewer pen lifts)
• reorder — sorts strokes so the pen travels the shortest path between them (less wasted time)

Together they routinely cut plot time 30–50% with zero visible quality change.

Step 1: Install it

vpype is a Python tool. With Python installed:

pip install "vpype[all]"

Confirm it works:

vpype --help

Step 2: Understand the pipeline

vpype works as a pipeline — each command reads the current state, transforms it, and passes it on. You chain commands in one line:

vpype read input.svg [transforms...] write output.svg

Always start with read and end with write. Everything in between transforms the geometry.

Step 3: Your first optimization

The command that does 90% of the work:

vpype read art.svg linemerge --tolerance 0.5mm reorder write plot.svg

• read art.svg — load your file
• linemerge --tolerance 0.5mm — join paths whose endpoints are within 0.5 mm
• reorder — minimize pen travel
• write plot.svg — save the optimized file

Send plot.svg to your plotter and watch it finish noticeably faster.

Step 4: Crop to your page

Stray elements outside your paper waste travel and can crash the head into the edge. Crop to your exact page:

vpype read art.svg linemerge reorder crop 0 0 297mm 420mm write plot.svg

That crops to A3 (297 × 420 mm). Adjust to your paper.

Step 5: Preview before you plot

See the result without leaving the terminal:

vpype read plot.svg show

This opens a preview window so you can confirm the geometry before committing ink.

A few more commands worth knowing

• scaleto 250mm 0 — scale art to a target width, keeping aspect
• linesort — alternative ordering optimizer
• layout a3 — center and lay out for a standard page
• Plugins (vpype-flow-imager, hatching tools) add noise, hatching, and image-to-line effects

The habit to build

Make vpype the last step before plotting, every time. Generate your art however you like, then run it through a vpype pipeline to merge, reorder, and crop. It’s the single easiest upgrade to your plotting workflow — and it’s free.

Frequently asked questions

What does vpype do?

vpype is a command-line tool that processes SVGs for pen plotting. Its core jobs are merging connected lines (fewer pen lifts) and reordering strokes (less wasted travel), which together make plots faster and cleaner. It also crops, scales, and supports many plugins.

Is vpype hard to learn?

No. You can get the main benefit with one command line. It's a pipeline of simple, chainable steps — read, transform, write — and you'll be optimizing plots within minutes.

Do I need vpype if I already use Inkscape?

They do different things. Inkscape designs and drives the plotter; vpype optimizes the geometry. Running files through vpype before plotting cuts time and pen lifts in a way Inkscape doesn't handle automatically.