> For the complete documentation index, see [llms.txt](https://docs.tempoweave.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tempoweave.com/help-by-menu-tabs/file-menu/settings-app-defaults-and-options.md). # 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 | 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. This directory is displayed under the Language field. #### 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
| 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

Gris Overlay and Numbering Defaults

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 | #### Scroll Bars Display Option If unchecked, Scroll Bars auto-hide until you hover. If checked, Scroll Bars remain at full size. ### Settings (Active Settings Tab) These settings take effect in the current application setting as well as when TempoWeave Studio is restarted. #### Theme
| 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
| 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 (Thumbnails)
| 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 | #### New Project Defaults
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
| 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. | *** #### Draft Style Options Controls the notation convention used for the drawdown. See video below. Swedish Defaults are normally: **Draft Style** Bottom to Top, **Origin Side** Right, **Shaft 1 Placement** At Top, **Treadle 1 Placement** On Right**.** American Defaults are normally: **Draft Style** Top to Bottom, **Origin Side** Right, **Shaft 1 Placement** At Bottom, **Treadle 1 Placement** On Left. Any combination of these settings may be used.
OptionDescription
Draft StyleTop to Bottom (Pick 1 is at the top, Last Pick is at the Bottom); Bottom to Top (Pick 1 is at the Bottom, Last Pick is at the top)
Origin SideRight (Warp thread 1 is on the right), Left (Warp Thread 1 is on the left side of the draft)
Shaft 1 PlacementBottom: Shaft 1 appears at the bottom of the warp and tie-up grids; Top: Shaft 1 appears at the top of the warp and tie-up grids.
Treadle 1 PlacementOn Left: Treadle 1 appears on the left side of the treadling and tie-up grids; On Right: Treadle 1 appears on the right side of the treadling and tie-up grids.
#### Default Shed Mode Controls the default rising or sinking shed mode applied when TempoWeave starts. This sets the initial selection of the Rising/Sinking Shed option on the Project menu. | Option | Description | | ------------------------- | ---------------------------------------------------------------------------- | | **Rising Shed** (default) | Black squares in the drawdown indicate warp threads that rise above the weft | | **Sinking Shed** | Black squares indicate warp threads that sink below the weft | #### Default Selection Mode Two independent settings — one for the **Warp / Weft headers** and one for the **Tie-up** — control how dragging selects cells. You can mix them: e.g. set Warp/Weft to Full while leaving Tie-up on Region (or vice versa). **Warp / Weft headers** | Option | Description | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Region** (default) | Selects a thread range bounded by the shafts (warp) or treadles (weft) you drag through — a rectangular region, the classic behavior. | | **Full Shaft / Treadle** | Selects *every* shaft (warp) or *every* treadle (weft) across the thread range you drag through. You only need to drag along the threads; the full height of shafts/treadles is selected automatically. | **Tie-up** | Option | Description | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Region** (default) | A free 2-D drag — selects exactly the rectangle of cells the pointer covers. | | **Full Shaft / Treadle** | The first axis of pointer movement after the click decides the band: drag mostly horizontally and the selection locks to the **full treadle column** (every shaft for that one treadle, drag extends across more treadles); drag mostly vertically and it locks to the **full shaft row** (every treadle for that one shaft, drag extends across more shafts). The axis stays locked for the rest of the drag so the band doesn't flicker. | > **Tip:** Hold **Shift** while dragging to temporarily use the *other* mode for that selection, in either axis. So with the default Region tie-up, Shift+drag uses Full mode for that drag; with Full set as the default, Shift+drag uses Region. The Shift behavior is identical on macOS, Windows, and Linux. > **Note:** A single click without dragging still just places the cursor in either mode, on either axis. #### 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
| 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 (removed) 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 | This video shows changing the settings for the Draft Style for the typical American and Swedish layouts. {% embed url="" %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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://docs.tempoweave.com/help-by-menu-tabs/file-menu/settings-app-defaults-and-options.md?ask= ``` 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.