All formats

Ricuci reads 13 formats and writes 10. The table shows what it can do with each one; rows link to the detail pages for the main formats.

Reading and writing

Format	Brand	Reads	Writes	Notes
VIP	Husqvarna / PFAFF	✓	✓	HUS body compressed with EmbCompress, no XOR.
ZHS	Husqvarna (newer)	✓	✓	Reverse-engineered writer. The first open writer in the world.
HUS	Husqvarna (old)	✓	✓	EmbCompress, without the VIP wrapper.
XXX	Melco / Barudan	✓	✓	Verified byte-for-byte against pyembroidery.
PES / PEC	Brother	✓	✓ (PES+PEC)	Colors matched to the nearest Brother threads.
DST	Tajima	✓	✓	Header + 3 bytes per stitch + tail. Painless.
JEF	Janome	✓	✓	Colors matched to the nearest Janome threads.
VP3	PFAFF / Husqvarna	✓	✓	Thread metadata, structured multicolor.
EXP	Melco	✓	✓	2 signature bytes per stitch. No colors, no hoop.
SEW	Janome (old, SewPro)	✓	—	Read-only. Old DA format.
SHV	Husqvarna (old)	✓	—	Read-only. Pre-VIP variant.
PCS	Pfaff (old)	✓	—	Read-only. PCD-style format.

Structured warnings

When a writer hits a command the target format cannot express, it falls back to a strategy and adds a structured warning to the conversion result. The UI shows the warnings in the results list. The known warnings:

FILLER_THREAD — the source file has no colors; the missing ones are marked black.
DELTA_63_SHIFTED — a stitch was too long; shortened by 0.1 mm.
COLOR_QUANTIZED — the format only knows its own threads; colors were matched to the nearest ones.
HOOP_FIT_EXCEEDED — the design is larger than the chosen hoop.
HOOP_UNSUPPORTED — the format does not know the requested hoop; the stock one was kept.
TRIM_DROPPED — the format cannot trim the thread; the TRIMs were removed.

Future porting

Formats that might land: SEW/SHV/PCS writing (old, marginal formats), CND (Melco CNDCondor), 10o (Bernina), EMD (Elna), PHB / GNC. The SEW/SHV/PCS reader already exists; the writer is open work. Adding a format = adding a file in readers/ or writers/ plus one line in registry.ts. That's all.

← Architecture VIP →