# WIF File Requirements

A WIF file is needed for a weaving project. The WIF file is a standard representation of a weaving draft.  This standard can be read and produced by all handweaving software. &#x20;

The threading, tie-up (if not a liftplan) and treadling should be representative of the draft that is to be woven.   It is not necessary to have all the repeats of the treadling or threading. &#x20;

TempoTreadle will wrap around to "pick 1" once the last weft pick is woven and continue to repeat the treadling sequence while incrememnting pick counters for total picks woven.

Colors from the WIF file will also be shown on the TempoTreadle system unit for threading and treadling.

When weaving on a table loom, be sure to have a Liftplan instead of a WIF with a tie-up. Weave design software programs have a feature to convert from tie-up to liftplan.

WIF files can either be copied (using File Explorer on Windows or Finder on Mac), or they can be saved directly from Weave Design Software onto the Micro-SD card.

If copying a long file name, be sure to rename the WIF file placed on the micro-sd card to meet the following requirements before loading into TempoTreadle.

{% hint style="info" %}
**File Name Requirements**

Maximum File Name Length (not including the .WIF extension):&#x20;

* Original TempoTreadle - 8 characters
* TempoTreadle II - 15 characters (if over 22, the file will not display on project load)

Avoid using these special characters in the file name:   **< > : " / \ | ? \***

Do not create and place WIF files in folders on the Micro-SD card
{% endhint %}

For more information about files on the micro-sd card, see [Broken mention](broken://pages/D4m7qs2NPu0SlAJljAXx)

The Notes field in WIF files is not support if over 32 characters.&#x20;

If you are a TempoWeave user, the "[Export for TempoTreadle](https://docs.tempoweave.com/documentation-by-menu-function/file-options/export-for-tempotreadle)" option formats an appropriate WIF for the SD-Card and removes notes, performs other validation checks before saving the copy to the Micro-SD card.  In addition, it builds the cache files for faster loading.

There is one feature used in many of the weaving design programs that allows the typing of notes that can cause an issue.  If the text is longer than 32 characters, TempoTreadle cannot load the WIF.  Various weave design programs refer to this field, which is a standard field in the WIF format, with a few different names.   Here are some examples of where these notes are found:

Fiberworks - Cloth | Notes and Records

PixeLoom - File | Properties | Notes

WeavePoint - Toolbar - Notes

TempoWeave - Project | Project Information | Project Notes

other weave design software may have slightly different names for this field.

If you have project notes in your WIF design, remove the notes in the version that you save to your Micro-SD card.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learning.loftyfiber.com/tempotreadle/tempotreadle-automatic-tracking-for-your-loom/wif-file-requirements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
