The Plaid Studio / Weaving software / WIF

What is a WIF file?

WIF — Weaving Information File — is the plain-text format weaving programs and computer-assisted looms use to exchange a draft. It holds the threading, the tie-up, the treadling and the colour of every thread, which is everything needed to weave the cloth again.

Make one from a thread count WIF 1.1 · part of the paid plans

What is inside one

A WIF is an INI-style text file: sections in square brackets, one key per line. You can open it in any text editor and read it. The parts that matter:

Those four together are a draft: the threading and tie-up describe how the loom is set up, the treadling describes what the weaver does, and the colours describe what it looks like. A drawdown — the picture of the woven cloth — can be computed from them, which is why a WIF is a description of cloth rather than a picture of it.

How to open a WIF file

  1. Weaving software. Fiberworks, WeavePoint, iWeaveIt, pyweaving and others read and write WIF; it exists precisely so they can hand drafts to each other.
  2. A dobby loom. Computer-assisted dobby looms take a draft this way, which is the practical reason to export one.
  3. A text editor. It is plain text. Opening it will tell you at a glance how many shafts and treadles it wants, and how long the draft is.

What a WIF is not: an image. There is no picture in the file. A program has to compute the drawdown from the threading, tie-up and treadling — so two programs can render the same WIF slightly differently, and none of them can show it without doing that work.

Getting a WIF out of a thread count

This is the part that is usually manual. Write a sett as a thread count, choose a structure, and the studio derives the draft from the drawdown itself — the threading, the tie-up, the treadling and every thread's colour — and writes WIF 1.1. The output has been read back with an independent reader (pyweaving) to confirm the draft in the file is the cloth on screen.

Two things worth knowing before you export:

Questions

What does WIF stand for?

Weaving Information File. It is an exchange format for weaving drafts, written as plain text in INI style, so that weaving programs and computer-assisted looms can pass drafts between each other.

What is in a WIF file?

The threading (which shaft each warp end goes through), the tie-up (which shafts each treadle lifts), the treadling (the order the treadles are pressed in), the colour table, and the warp and weft counts. Together those are a full draft.

How do I open a WIF file?

In weaving software such as Fiberworks, WeavePoint, iWeaveIt or pyweaving, or on a computer-assisted dobby loom. It is also plain text, so a text editor will show you what it asks for.

Is a WIF an image file?

No. It contains no picture. The drawdown — the image of the woven cloth — is computed from the threading, tie-up and treadling by whatever program opens it.

Can I make a WIF from a tartan thread count?

Yes. Write the sett as a thread count, pick a structure, and the studio derives the draft and writes WIF 1.1. Exporting it is part of the paid plans.