gitfurl
Run a Windows installer you already have on Linux, in its own Wine environment, with a plan you approve first.
Getting started · User guide · Status and known issues · AI use · Community · Report a bug

gitfurl is a graphical app (with an optional command line) for running a Windows installer on Linux through Wine. You supply the installer. Gitfurl does not find, download or include any.
Version 1.3.0, released 2026-11-18. The app, the command line and the safety checks are complete for the scope in docs/scope.md. That does not mean any particular installer works: compatibility is unverified, a complete install has been tested only with an installer built for the test, and the code has not been audited. Details: docs/status.md.

The Library page with demo prefixes (empty folders). No installer was run to make this picture. More pictures are in the user guide.

Getting started
The latest release has a single-file Linux program and a SHA256SUMS file (check it with sha256sum -c SHA256SUMS). It is not proven on every desktop (see docs/status.md). Or run it from source. You need Linux and Wine; from source also Python 3.11 or newer and tkinter (python3-tk on Debian and Ubuntu).
git clone https://github.com/undecuple/gitfurl.git && cd gitfurl
python -m gitfurl cli doctor reports Wine, tkinter, bubblewrap and umu-run.
python -m gitfurl, press + New prefix, name it, open it.
- Pick your installer, read the plan, press Run installer and confirm.
- Gitfurl shows the exit status and where the log is.
Terminal instead: python -m gitfurl cli --help (same code, same approvals).

When you probably do not need it
- If you are happy running Wine yourself, you do not.
- Gitfurl is for the installer step. It is not a game launcher or a library manager, and it does not claim to run any particular installer.
- Wine prefixes are not sandboxes. Gitfurl makes the run visible and tidy; it does not make an untrusted installer safe.

Read more

Privacy
Nothing goes online from gitfurl itself: no network requests, no telemetry, no uploads. Two things you start yourself can use the network: umu-run downloading its runtime on first use, and anything the installer does. Prefixes live in ~/.local/share/gitfurl/prefixes/ and logs in ~/.local/state/gitfurl/logs/ (readable only by you; they can hold your user name and local paths, so remove those before sharing one). Nothing is written to ~/.wine.

Community
Questions and discussion: the gitfurl forum on the undecuple Discord server. Bugs go to GitHub issues, security problems to private advisories. Remove your user name and local paths from logs before posting them. Contributing: CONTRIBUTING.md.

Related projects
Wine (the compatibility layer gitfurl drives), umu-launcher with Proton and GE-Proton (the optional runtime; gitfurl ships none of them) and vim-tictoc (the colour scheme). Gitfurl is not affiliated with these projects or with any software publisher.

Licence
Copyright (C) 2026 undecuple. GPL-3.0-or-later; see LICENSE. The images in assets/ are generated by tools/make_assets.py and are under the same licence. The licence covers gitfurl only, not any installer or software you run with it.

AI use
Gitfurl is written with AI coding agents. Much of its code, tests and documentation was written by Claude (Anthropic's model, used through Claude Code) under the maintainer's direction. A second Claude session reviews each change before it goes public, and the maintainer approves every merge, tag and release. The code has not been audited by a security professional (see SECURITY.md). Read the plan before you approve a run, and report problems through the issue forms.

Disclaimer
Gitfurl comes with no warranty, as in section 15 of the GPL. You are responsible for what you run and for being authorised to use it. Names of other products belong to their owners; gitfurl is not affiliated with them. Running an installer can harm your system; a Wine prefix is not a sandbox.