> 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/installation-and-licensing/installing-tempoweave-studio.md). # Installing TempoWeave Studio TempoWeave Studio runs on macOS, Windows, and Linux. This guide walks you through downloading, installing, and getting started on each platform. *** ### Downloading TempoWeave Studio Visit the TempoWeave Studio website to download the installer for your operating system. You'll see options for: * **macOS** — PKG installer (recommended — required for automatic updates) or DMG disk image * **Windows** — Standard installer * **Linux** — AppImage (available for both x64 and arm64 processors) * **Chromebook** — the Linux AppImage, run through ChromeOS's built-in Linux environment (see the Chromebook section below) *** ### macOS Installation #### Using the PKG Installer (Recommended) The PKG installer is the recommended way to install TempoWeave Studio on macOS. It enables automatic updates, so you'll always have the latest version without needing to re-download. 1. Double-click the downloaded `.pkg` file 2. Follow the on-screen prompts — the installer will place TempoWeave Studio in your Applications folder 3. Open TempoWeave Studio from your Applications folder or Launchpad **First Launch on macOS** macOS may show a security prompt the first time you open TempoWeave Studio. This is normal — Apple requires all applications to be verified before running. If you see a message saying the app "cannot be opened": 1. Open **System Settings** (or System Preferences on older macOS) 2. Go to **Privacy & Security** 3. Scroll down and you'll see a message about TempoWeave Studio being blocked 4. Click **Open Anyway** You only need to do this once. After that, TempoWeave Studio will open normally every time. **Tip:** You can also right-click (or Control-click) the app and choose **Open** from the menu. This bypasses the security dialog directly. #### Using the DMG Installer If you prefer a DMG disk image: 1. Double-click the downloaded `.dmg` file to mount it 2. Drag the TempoWeave Studio icon to the Applications folder shortcut shown in the window 3. Eject the disk image 4. Open TempoWeave Studio from your Applications folder **Important:** DMG installations do not support automatic updates. You'll need to download and install new versions manually. For this reason, we strongly recommend using the PKG installer instead. #### macOS Compatibility TempoWeave Studio runs natively on both Apple Silicon (M1, M2, M3, M4) and Intel Macs. You don't need to choose a version — the installer includes support for both processor types and will use the right one automatically. *** ### Windows Installation 1. Double-click the downloaded installer 2. Follow the on-screen prompts to complete the installation 3. TempoWeave Studio will appear in your Start Menu **Windows SmartScreen** If Windows shows a SmartScreen warning ("Windows protected your PC"), click **More info** and then **Run anyway**. This can happen with newly released versions and is not a security concern. Once installed, TempoWeave Studio will check for updates automatically and notify you when a new version is available. *** ### Linux Installation #### System Requirements * Ubuntu 22.04 or newer (or compatible distribution) * x64 or ARM64 processor #### Step 1: Install required library AppImage files require FUSE to run. Open Terminal and run the commands for your distribution. This only needs to be done once. **Ubuntu 24.04 and newer:** ``` sudo apt install libfuse2t64 ``` **Ubuntu 22.04 / 23.10 and older, Debian 12:** ``` sudo add-apt-repository universe sudo apt install libfuse2 ``` The library was renamed starting with Ubuntu 24.04 — if one package name isn't found, try the other. **Arch Linux / Manjaro:** ``` sudo pacman -S fuse2 ``` **Fedora:** ``` sudo dnf install fuse-libs ``` Enter your password when prompted. #### Step 2: Download TempoWeave Studio Download the TempoWeave Studio AppImage from your account at tempoweave.com. #### Step 3: Make it executable Right-click the downloaded file, then Properties, then Permissions, and check "Allow executing file as program." Or in Terminal: ``` chmod +x ~/Downloads/TempoWeave*.AppImage ``` #### Step 4: Launch Double-click the AppImage file, or in Terminal: ``` ~/Downloads/TempoWeave*.AppImage ``` #### Troubleshooting **Nothing happens when you double-click, or you see "AppImages require FUSE to run"** — go back to Step 1 and install the FUSE library (`libfuse2t64` on Ubuntu 24.04 and newer, `libfuse2` on older releases). **Still not launching?** Run it from Terminal to see the error message: ``` ~/Downloads/TempoWeave*.AppImage ``` You can also run the app without FUSE at all: ``` ~/Downloads/TempoWeave*.AppImage --appimage-extract-and-run ``` **Using AppImageLauncher or another integration tool?** Try launching the AppImage directly from Terminal as above — integration tools sometimes interfere on newer distributions. For help, contact — include your distribution version and any Terminal output. *** ### Automatic Updates TempoWeave Studio checks for updates in the background, every two hours while it is running. When a new version is found it downloads first, so by the time you see anything the update is usually ready to install. **When a release matters to everyone,** the update dialog opens on its own a few seconds after the check, once per version and never over another dialog. **For a minor release** only the ribbon pill appears, reading **Update to** followed by the version; click it whenever you like. The dialog shows the new version, the version you have, a **What's new** link with the address shown as selectable text and a **Copy link** button beside it, and a status line: downloading with a progress bar, or downloaded and ready. From there you can choose: * **Restart now** — Installs the update and restarts the app. If you have unsaved work, you'll be prompted to save first. On a Mac, a short notice explains the password prompt that macOS shows while the update is applied. * **Install when I close** — Keeps the app running; the update installs as the app exits, without restarting it. The pill stays visible meanwhile. * **Later** — Closes the dialog. The pill stays, and the dialog comes back on its own in three days. * **Skip this version** — Won't ask about this specific version again. You'll still be notified about future versions. You can turn off automatic checks in **Settings** if you prefer to update by hand through **Help → Check for Updates**. **Note:** Installing updates in place requires the PKG installer on macOS. If you installed by dragging from a DMG, the app still tells you when a new version is out, but the dialog offers a **Download installer** button instead: run the installer you download, and your drafts and settings are kept. The Intel build for older Macs works the same way. *** ### Uninstalling **macOS:** Drag TempoWeave Studio from your Applications folder to the Trash. **Windows:** Use "Add or Remove Programs" in Windows Settings, or the uninstaller in the Start Menu. **Linux:** Simply delete the AppImage file. Your settings and preferences are stored separately and are not removed when you uninstall, so if you reinstall later your preferences will still be there. *** ### Chromebook Installation TempoWeave Studio runs on Chromebooks through the built-in **Linux development environment** (sometimes called Crostini). This guide walks you through enabling Linux on your Chromebook and installing TempoWeave. #### Is my Chromebook compatible? Most Chromebooks made from 2019 onward can run Linux apps. To check: 1. Open **Settings** 2. Look for **About ChromeOS** → **Additional details** 3. Confirm your ChromeOS version is 80 or newer 4. Open **Advanced** in Settings and look for **Developers** If you see a **Linux development environment** option, you're good. If you don't see it at all, your Chromebook is too old or was sold into a school/enterprise account that restricts Linux. Ask your IT administrator, or try a different Chromebook. **Recommended specs** * **RAM**: 4 GB minimum, 8 GB recommended for larger drafts * **Storage**: At least 10 GB free on your Chromebook * **Processor**: Intel, AMD, or ARM — TempoWeave supports all three #### Step 1: Turn on Linux 1. Open **Settings** 2. Click **Advanced** in the left sidebar, then **Developers** 3. Click **Turn on** next to **Linux development environment** 4. Follow the setup wizard — accept the defaults. Choose a username (any name is fine) and allocate at least **10 GB** of disk space 5. Wait a few minutes for the setup to finish. A **Terminal** app will open when it's ready You only need to do this once. #### Step 2: Find out if your Chromebook is ARM or Intel/AMD TempoWeave Studio comes in two Linux builds — one for ARM processors and one for Intel/AMD. Most newer, lightweight Chromebooks use ARM. Most larger or higher-end Chromebooks use Intel or AMD. In the **Terminal** app, run: ``` uname -m ``` * If it says **`aarch64`** — download the **ARM64** build * If it says **`x86_64`** — download the **x64** build #### Step 3: Install the required library TempoWeave uses the AppImage format, which needs a small library called FUSE. In the **Terminal**, run: ``` sudo apt update sudo apt install libfuse2 ``` If that reports the package isn't found (newer Linux containers renamed it), run this instead: ``` sudo apt install libfuse2t64 ``` Enter your Linux password when prompted. This only needs to be done once. #### Step 4: Download TempoWeave Studio 1. Open the **Files** app on your Chromebook 2. Sign in to your account at [tempoweave.com](https://tempoweave.com) and download the Linux build that matches your architecture from Step 2 3. The file will land in **Downloads** (the ChromeOS Downloads folder, not the Linux one) **Move the download into the Linux container** Linux apps can't see ChromeOS files by default. You need to share the file with Linux: 1. In the **Files** app, find the downloaded TempoWeave AppImage 2. Right-click the file and choose **Share with Linux**, or drag it into the **Linux files** folder in the sidebar #### Step 5: Make it executable In the **Terminal** app: ``` cd ~ chmod +x TempoWeave*.AppImage ``` (If you put the file somewhere other than your Linux home folder, adjust the path accordingly.) #### Step 6: Launch TempoWeave Double-click the AppImage in the **Linux files** folder, or in the **Terminal**: ``` ~/TempoWeave*.AppImage ``` The first launch takes a few seconds longer than later launches. TempoWeave will appear in your ChromeOS app launcher after the first run, so you can pin it to your shelf for quick access. #### Working with your draft files **Opening WIF files from ChromeOS** Linux apps can only open files that live in the **Linux files** folder, or folders you've explicitly shared with Linux. To work with your WIF files: * **Easiest**: Keep your WIF files in the **Linux files** folder * **Alternative**: Right-click any folder in the Files app and choose **Share with Linux** — that folder and its contents become visible to TempoWeave **Saving files** When you save from TempoWeave, files are saved inside the Linux container by default. They show up in the ChromeOS **Files** app under **Linux files** — you can copy, email, or upload them from there. **Google Drive and cloud storage** Google Drive files don't sync into the Linux container automatically. To open a Drive file in TempoWeave, first copy it from **Google Drive** into **Linux files** using the ChromeOS Files app. #### Performance notes * **Lightweight Chromebooks** (4 GB RAM, older ARM chips) run TempoWeave fine for small to medium drafts. Very large drafts with 3D Interlacement or Cloth Simulation may feel slow. * **Higher-end Chromebooks** (8 GB+ RAM, newer chips) handle large drafts comfortably. * TempoWeave's rendering is optimized for low-end hardware — viewport culling means only visible cells are drawn. #### Known limitations on Chromebook * **Printing**: Every Print button in TempoWeave (Print Threading, Print Project Report, Print Sleying Guide, and so on) generates a PDF and tries to open it in your system's default PDF viewer. On a Chromebook that handoff can fail with "Your file couldn't be accessed": TempoWeave runs inside the Linux container and writes the PDF there, and ChromeOS's built-in viewer can't see into the container. The fix is a Linux-native PDF viewer, so the PDF opens inside Linux instead of trying to cross over to ChromeOS. The easiest one: 1. Open the Linux **Terminal**. 2. Run: `sudo apt install evince` 3. Enter your password if prompted, then `y` to confirm. After that, any Print button opens the PDF in Evince, a clean, simple reader. From Evince you can save the PDF into **Linux files**, and from the Files app ChromeOS can send it to a real printer. * **File associations**: Double-clicking a .wif or .twa file in the ChromeOS Files app won't open TempoWeave automatically. Instead, open TempoWeave first, then use **File → Open**. * **Audio chimes**: The Weave Assistant's chime feature depends on Linux audio passthrough. On most Chromebooks this works, but if chimes are silent, try adjusting your ChromeOS volume or restart the Linux container (Settings → Developers → Linux → **Shut down**). #### Troubleshooting **"AppImages require FUSE to run"** — Go back to Step 3 and install libfuse2. **"Permission denied" when launching** — Go back to Step 5 and run `chmod +x` on the AppImage. **The app window is blank or flickers** — Restart the Linux container (Settings → Developers → Linux → **Shut down**), then try launching again. **Fonts look wrong or blocky** — Install a basic font package in Terminal: ``` sudo apt install fonts-liberation fonts-noto ``` **The app won't launch at all** — Run it from the Terminal to see the error message: ``` ~/TempoWeave*.AppImage ``` Copy the error and send it to ****. #### Getting help For Chromebook-specific issues, contact **** with: * Your Chromebook model (Settings → About ChromeOS) * The output of `uname -m` from Terminal * The error message (if any) For general TempoWeave questions, the full documentation is at [tempoweave.com](https://tempoweave.com).