Command line (CLI)

The same conversions as the web app, from a terminal — for scripts, automation and batch jobs. Zero install with npx, or a standalone binary that needs no Node.

Quick start

npx ricuci input.vip output.zhs

npx downloads and runs the package in one shot — there is no install step. It needs Node ≥18. The package is ricuci on npm, with no runtime dependencies (the core is bundled in).

Getting it

• With npx (recommended) — nothing to install: npx ricuci …
• Global install — if you use it often: npm install -g ricuci, then ricuci …. The package also installs an embconv alias, so scripts written against it keep working.
• Standalone binary — no Node: download embconv-windows-x64.exe / -macos-arm64 / -macos-x64 / -linux-x64 from the releases.

Commands

Single conversion

ricuci input.pes output.jef

The format is inferred from the file extensions. Any readable format converts to any writable one (see Formats).

Inspect a file

ricuci info design.vip --brand janome

Prints the format, stitch count, colors, size in mm, the declared hoop and the smallest hoop that fits the design (per brand).

Batch conversion

ricuci --batch folder/ --to zhs --out results/

Converts every readable file in a folder to the --to format, writing into --out (or the same folder if omitted).

Options

• --hoop <WxH> — target hoop in mm (e.g. --hoop 130x180) for formats that declare one (pes, jef, zhs).
• --center — center the design on the origin before writing.
• --pause-trims — zhs: stop the machine at each mid-color trim (to cut the thread there) instead of dropping trims silently.
• --brand <brand> — in info, check the fit against that brand's hoops.

Examples

# convert a folder of PES to ZHS
ricuci --batch ./designs --to zhs --out ./zhs

# convert declaring a hoop and centering
ricuci logo.pes logo.jef --hoop 130x180 --center

# how many stitches and colors does this file have?
ricuci info eagle.dst

← Architecture Formats →