DESKTOP APP A local workbench

Put TimeGleam
on your own machine.

The web studio owns the canvas, timeline, and finished film. The desktop app is a second workbench inside the same workspace: an agent can read and write files in directories you authorize, run scripts, organize assets, and call the remote tools and models your account is already allowed to use. Both entry points show one copy of the work, not two.

Current version

Windows 10 / 11 · 64-bit

Preview
Download installer 303 MB China mirror same file, same digest

Both addresses serve the same installer with the same SHA-256: the primary source sits outside mainland China, the mirror on the mainland. Take whichever is faster; either checksum file verifies either download.

Version
0.2.2-alpha.3.20261115.1
Filename
timegleam-0.2.2-alpha.3.20261115.1-win-x64-unsigned.exe
Fixed link
Always the latest preview build

SHA-256 e05e8908f4016505521d68d7c3cc97e06b159d90a38a85ee61e6efd3ddc17baf Download checksum

Unsigned preview build. Windows SmartScreen may warn once: choose “More info”, then “Run anyway”. The installer targets the current user only and never requests administrator rights.

Other platforms

macOS · Linux

There is no downloadable installer for these platforms yet. Use the web studio meanwhile; features and workspace data are the same. If you need a local agent today, connect your own tools to the same workspace through remote MCP.

We do not list platforms that have no build. When a build exists, this page will show its button and checksum directly.

ONE LINE Or install with one command

Use one of these when you would rather not download the file by hand, or you are setting up another machine. The command reads the .sha256 at the fixed address, downloads the installer, and only proceeds when the digest matches. Both do the same thing on Windows; pick either.

Windows · PowerShell (5.1 and 7) irm https://timegleam.com/install/timegleam.ps1 | iex
Windows · Git Bash / WSL curl -fsSL https://timegleam.com/install/timegleam.sh | sh

The default is a silent install for the current user with no administrator prompt; an existing copy upgrades in place and keeps local sessions and material. A dropped connection does not throw away what already arrived: the partial file stays in the temp directory, the script resumes it with byte ranges and retries up to six times — just run the same command again once the network is back. To see the steps without touching the machine, set TIMEGLEAM_DRY_RUN=1 in the same terminal first. On a slow mainland connection, set TIMEGLEAM_BASE=https://timegleam.lanhc.com before the command so the script pulls the same installer from the mirror; verification is unchanged.

Four steps.
Start with the smallest path.

  1. Download and run the installerDouble-click the downloaded .exe and follow the prompts. It installs under the current user, not into a system directory.
  2. First launch stops on the welcome pageThe desktop app and older editions are separate installations. They do not overwrite each other and do not inherit old data.
  3. Sign in with your TimeGleam accountChoose sign-in on the welcome page; your browser opens the TimeGleam account page, and the app finishes signing in by itself. You can also paste an existing key that starts with tmg_.
  4. Check the workspace, then verify the connectionConfirm the current workspace is the one you want, then have the agent read your work list. Real titles and ids mean the connection works; do not start by producing a film.

Key lifetime and revocation: desktop keys last 30 days by default. When you change machines, share a computer, or suspect a leak, revoke the tool under “Account security → Connected tools” on the website and sign in again. Never paste the key into a script, prompt, or chat.

What it needs

Actual conditions for installing and running the desktop app
SystemWindows 10 or Windows 11, 64-bit (x64)
DiskAbout 1.1 GB installed, plus room for local assets and session data
AccountA TimeGleam account that already belongs to a workspace; the welcome page will not continue without one
PrivilegesInstalls and runs as the current user only; the installer never requests administrator rights
Data directory~/.timegleam in your user directory by default; set DSH_HOME before launching to keep a separate directory

The app bundles the Python, Node.js, and package manager it needs, so nothing has to be preinstalled. Workspace dependencies are unpacked on first use, which makes that first call slower.

What it adds,
and what it does not.

Two things it really adds

  • Local execution.The agent reads and writes files in directories you authorize, renames in batches, runs scripts, and assembles receipts. A browser cannot do this.
  • Work continues after you close the window.No tab has to stay open for a task to finish.

The limits stay the same

  • Remote tools map one-to-one onto website buttons; there is no desktop-only hidden generation endpoint.
  • Images, videos, and finished films still settle against workspace points: a quote first, then confirmation. The server computes the amount; the app never prices anything itself.
  • Member permissions, workspace authorization, and revocation behave exactly as they do on the website.

Upgrading and uninstalling

Common questions

Windows says it protected my PC. What now?

That is the expected warning for an unsigned installer. Choose “More info”, then “Run anyway”. We never ask you to disable antivirus software or system protection.

The download is slow or stopped.

The installer is about 303 MB and the fixed link supports resuming. Once it finishes, compare it against the SHA-256 checksum on this page so you know you did not install a modified build.

Sign-in says I have no workspace.

The desktop app needs at least one workspace. Create one in the web studio, then sign in again from the desktop app.

Are desktop and web data separate?

No. The desktop app edits the same works, episodes, canvases, and films in the same workspace. Adoptions and timeline edits made there appear on the website after a refresh.

Can I keep the older edition installed?

They are separate installations: neither overwrites the other, and neither inherits old data. When both are installed, keep their shortcuts and data directories distinct.

What to read after installing