# Settings (app defaults & options)

### Default Settings

The Settings dialog lets you configure TempoWeave's behavior, appearance, and defaults for new projects. Settings are saved automatically and persist between sessions.

**Location:** File (backstage) → Settings

The dialog has two tabs: **Default Settings** (for new projects and startup) and **Settings** (for the current application session).

#### Startup Options

<figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2FIBATz1DpsesgQOOotjCg%2Fimage.png?alt=media&#x26;token=891b33c6-a445-49fd-8d25-610506dccb75" alt="" width="375"><figcaption><p>Sample Screen for Startup Options (requires scrolling to see all options)</p></figcaption></figure>

| Setting                   | Description                                                                                                                                |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Load Draft on Startup** | When checked, automatically opens a draft when TempoWeave launches                                                                         |
| **Open Default Project**  | Opens the built-in blank project (or your custom default)                                                                                  |
| **Reload Last Project**   | Reopens the last file you were working on                                                                                                  |
| **Default Project**       | Choose a custom WIF file to use as your default starting draft. Click Browse to select a file, or Clear to return to the built-in default. |

#### Language

| Setting      | Description                                                                                                |
| ------------ | ---------------------------------------------------------------------------------------------------------- |
| **Language** | Choose from System Default, English, Français, Deutsch, or Español. Changes require restarting TempoWeave. |

> **Tip:** You can create custom translations by editing the JSON files in the `Locales/` folder within the application directory.

#### View Options

| Setting                  | Description                                                                                                                                               |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Show Yarn Catalog**    | Display the yarn catalog panel when TempoWeave starts                                                                                                     |
| **Initial Drawing Tool** | The drawing tool selected by default: Straight, Freehand, Line, or Point                                                                                  |
| **Use GPU 3D View**      | Enable GPU-accelerated rendering for View Fabric and Cloth Simulation. If you experience display issues, uncheck this to use CPU-based rendering instead. |

#### View Style Options

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2FGFTtaLhfdgIIGyMIUZ3f%2Fimage.png?alt=media&#x26;token=45fcd646-c710-4242-bb8b-9d8eb389529a" alt="" width="375"><figcaption></figcaption></figure></div>

| Setting                | Description                                               |
| ---------------------- | --------------------------------------------------------- |
| **Show Interlacement** | Render interlacement shading effects in the drawdown view |
| **Grayscale Drawdown** | Desaturate cloth colors in the drawdown                   |
| **Grayscale Palette**  | Desaturate all palette colors                             |
| **Show Thickness**     | Display thread thickness visualization                    |

#### Tie-Up Style

Controls how the tie-up matrix is displayed:

| Option            | Description                                                  |
| ----------------- | ------------------------------------------------------------ |
| **Block Style**   | Filled blocks showing shaft-to-treadle connections (default) |
| **Numeric Style** | Numbers displayed in each cell                               |

#### Warp Header Style

Controls how the threading (warp) header is displayed:

| Option            | Description                                       |
| ----------------- | ------------------------------------------------- |
| **Block Style**   | Filled blocks showing shaft assignments (default) |
| **Numeric Style** | Shaft numbers displayed in each cell              |
| **Color Style**   | Cells colored by thread color                     |
| **Visible**       | Show or hide the warp header entirely             |

#### Weft Header Style

Same options as Warp Header Style, applied to the treadling (weft) header.

#### Grid Overlay Defaults

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2FYLpx6e9GmoA1O3h282At%2Fimage.png?alt=media&#x26;token=117b5a0b-3570-4140-90b9-eca14155b6b1" alt="" width="375"><figcaption><p>Gris Overlay and Numbering Defaults</p></figcaption></figure></div>

Configure the grid overlay that helps with counting threads and picks:

| Setting                    | Description                                                                              |
| -------------------------- | ---------------------------------------------------------------------------------------- |
| **Drawdown**               | Show grid overlay on the main drawdown canvas                                            |
| **Warp**                   | Show grid overlay on the threading canvas                                                |
| **Tie-Up**                 | Show grid overlay on the tie-up matrix                                                   |
| **Weft**                   | Show grid overlay on the treadling canvas                                                |
| **Shaft Row Interval**     | Spacing between horizontal grid lines (3–14, default 4)                                  |
| **Thread Column Interval** | Spacing between vertical grid lines (4–20, default 10)                                   |
| **Overlay Color**          | Grid line color: Dark Gray, Dark Red, Dark Blue, Dark Green, Dark Magenta, or Orange Red |

### Active Settings Tab

These settings affect the current application session and general behavior.

#### New Project Defaults

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2FDoGNe4s5AGcc6RnqwTl9%2Fimage.png?alt=media&#x26;token=8f345a04-04ee-4521-af28-14db9ce0899a" alt="" width="375"><figcaption></figcaption></figure></div>

These values are used when creating a new draft:

| Setting                | Description                                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Shafts**             | Number of shafts (2–128, default 8)                                                                                                       |
| **Treadles**           | Number of treadles (2–128, default 10)                                                                                                    |
| **Loom Type**          | Tie-Up or Liftplan                                                                                                                        |
| **Unit of Measure**    | Imperial (Inches) or Metric (cm)                                                                                                          |
| **Initial Zoom**       | Starting zoom level (1–40, default 10)                                                                                                    |
| **Default Palette**    | A yarn palette to load automatically for new projects. Choose from the Yarn Catalog or MyYarns collections, or "None" for default colors. |
| **Default Warp Color** | Starting warp thread color from the selected palette                                                                                      |
| **Default Weft Color** | Starting weft thread color from the selected palette                                                                                      |

#### File Locations

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2Fd9AjhxTKunlgBJwij9lT%2Fimage.png?alt=media&#x26;token=69f504c3-c620-46ee-8faf-705f10ff6b7e" alt="" width="375"><figcaption></figcaption></figure></div>

| Setting                  | Description                                                                                                 |
| ------------------------ | ----------------------------------------------------------------------------------------------------------- |
| **Default WIF Location** | The folder that opens by default when saving WIF files. Click Browse to choose a folder, or Clear to reset. |

***

#### Theme

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2FsZoBY8iVMJtWcyj7jybT%2Fimage.png?alt=media&#x26;token=999831fc-c5bc-4161-9d4d-d08ea46e99e2" alt="" width="375"><figcaption></figcaption></figure></div>

| Setting          | Description                                                        |
| ---------------- | ------------------------------------------------------------------ |
| **Appearance**   | Light, Dark, or System (follows your OS setting). Default: System. |
| **Accent Color** | The highlight color used throughout the interface. Default: Blue.  |

Theme changes apply immediately — no restart needed.

#### Application Settings

| Setting                      | Description                                                 |
| ---------------------------- | ----------------------------------------------------------- |
| **Telemetry Enabled**        | Send anonymous usage data to help improve TempoWeave        |
| **Version History Enabled**  | Keep a history of file versions for recovery                |
| **Remember Window Position** | Restore the window size and position from your last session |

#### File Associations

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2Fg9Ogq8eLeSaEVH3RACCr%2Fimage.png?alt=media&#x26;token=c3acae9b-7ca7-4403-bf03-da1567091a63" alt="" width="375"><figcaption></figcaption></figure></div>

| Setting                         | Description                                                                                                                                  |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Register as Default Handler** | Associate .wif and .twa files with TempoWeave so they open with a double-click. The current registration status is shown below the checkbox. |

#### Pattern Browser Settings

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2FPlJC3LSROYrBHHz0nUKn%2Fimage.png?alt=media&#x26;token=f9c621bf-85be-4403-9725-8cfb6ddee9f0" alt="" width="375"><figcaption></figcaption></figure></div>

| Setting                               | Description                                                                                                                |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Enable Pattern Browser**            | Turn on the pattern browser for browsing WIF files visually                                                                |
| **Thumbnail Size**                    | Small (96px), Medium (160px, default), or Large (256px)                                                                    |
| **Max Thumbnails**                    | Limit how many thumbnails are cached: 50 to 5,000, or Unlimited                                                            |
| **Generate Thumbnails in Background** | Generate thumbnails automatically when browsing folders. If disabled, thumbnails are generated only when you click a file. |
| **Clear Thumbnail Cache**             | Purge all cached thumbnails to free disk space                                                                             |

#### Draft Style

Controls the notation convention used for the drawdown:

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2FQer3nGHHP4xb3Zsujodl%2Fimage.png?alt=media&#x26;token=a431f5c9-785e-4ce8-b40c-3587749f4dcf" alt="" width="375"><figcaption></figcaption></figure></div>

| Option                 | Description                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------- |
| **American** (default) | Shaft 1 at the bottom, treadling reads top-to-bottom, black squares indicate warp rises |
| **Swedish**            | Shaft 1 at the top, treadling reads bottom-to-top, black squares indicate warp sinks    |

> **Note:** Changing draft style affects how the drawdown is displayed and interpreted. If you're following a pattern, make sure your style matches the pattern's convention.

#### Show Thread Markers

When enabled, displays blue locator marks at the edges of the threading, tie-up, and treadling grids to help identify the active row and column. On by default.

#### Cloud Library Settings

*These settings appear only when the Cloud Pattern Library feature is enabled.*

<div align="left"><figure><img src="https://2959107664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqXhf7V7Tz3hzEGNlTxL%2Fuploads%2Fk0DW4ZFs8dOb3zlYg5WB%2Fimage.png?alt=media&#x26;token=ba52022d-2217-4361-b7a2-7315c65a1a20" alt="" width="375"><figcaption></figcaption></figure></div>

| Setting          | Description                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Display Name** | Your name as shown to others in the Cloud Pattern Library. Click Save to update it across all your shared patterns. |

#### AI Draft Generation Settings

*These settings appear only when the AI Draft feature is enabled.*

| Setting            | Description                                                                      |
| ------------------ | -------------------------------------------------------------------------------- |
| **Claude API Key** | Your API key for AI-powered draft generation. Click Test Key to verify it works. |
| **AI Model**       | Choose between Claude Sonnet (more capable) or Claude Haiku (faster).            |

***

### Update Settings

Update settings are accessed separately from **Help → Check for Updates**.

| Setting                    | Description                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Auto Check for Updates** | Automatically check for new versions on startup                                                        |
| **Skipped Version**        | If you previously chose to skip a version, it's shown here. Click Clear to be notified about it again. |
| **Check for Updates Now**  | Manually check for available updates                                                                   |