Install rtm
Download rtm 26.2.0
-
GNU/Linux
x86-64
.deb .rpm AppImage -
macOS
Apple Silicon and Intel
.dmgrtmcli: .tar.gz
-
Windows
x64
.msirtmcli: .exe
Nix: nix profile add github:brcha/rtm/v26.2.0#rtmapp, or
github:brcha/rtm/releases/v26.2#rtmapp to follow the 26.2 fixes
(more).
Once installed, rtm can also serve your todo.txt to an AI assistant: see Use rtm with AI assistants.
Download the files from the latest GitHub Release.
<version> below stands for the release version, for example 26.1.0.
GNU/Linux (x64)
The debs install on Ubuntu 22.04 and newer and Debian 12 and newer. The RPMs install on Fedora, RHEL 9 and 10 and their clones (AlmaLinux, Rocky Linux), and openSUSE Leap 16.0 and Tumbleweed.
Desktop app, deb:
- Download
rtmapp_<version>_amd64.deb. - Run
sudo apt install ./rtmapp_<version>_amd64.deb. This also installs the XDG desktop portal with a file chooser (gtk, gnome or kde), which opening a file needs. - Start "Rusty Todo.txt Manager" from the application menu, or run
rtmapp.
It runs on Wayland; X11 works with the X11 libraries the package suggests.
Desktop app, RPM:
- Download
rtmapp-<version>-1.x86_64.rpm. - Run
sudo dnf install ./rtmapp-<version>-1.x86_64.rpm(Fedora, RHEL), orsudo zypper install --allow-unsigned-rpm ./rtmapp-<version>-1.x86_64.rpm(openSUSE). This also installs the XDG desktop portal with a file chooser (gtk, gnome or kde). - Start "Rusty Todo.txt Manager" from the application menu, or run
rtmapp.
Desktop app, AppImage (for other distributions):
- Download
rtmapp_<version>_amd64.AppImage. - Run
chmod +x rtmapp_<version>_amd64.AppImage. - Run
./rtmapp_<version>_amd64.AppImage.
CLI:
- Download
rtmcli_<version>_amd64.deborrtmcli-<version>-1.x86_64.rpm. - Run
sudo apt install ./rtmcli_<version>_amd64.deb,sudo dnf install ./rtmcli-<version>-1.x86_64.rpmorsudo zypper install --allow-unsigned-rpm ./rtmcli-<version>-1.x86_64.rpm. - Run
rtmcli --help.
Nix and NixOS
The flake provides rtmcli and rtmapp. From a checkout, build them with nix build .#rtmcli and
nix build .#rtmapp; without one, install them into your profile with
nix profile add github:brcha/rtm#rtmapp (or #rtmcli).
github:brcha/rtm follows main, the development branch. To install a release instead, name a
release tag or a release branch:
github:brcha/rtm/v<version>: that release, which never changes, for examplenix profile add github:brcha/rtm/v<version>#rtmapp.github:brcha/rtm/releases/v<line>: the branch of a release line, for examplereleases/v26.1for the 26.1 releases. It gets the line's fixes as soon as they are merged, before their patch release;nix profile upgrade rtmappupdates to it.
To try a release without installing it, run it:
nix run github:brcha/rtm/v<version>#rtmcli -- --help.
To install them on NixOS from a flake-based configuration:
-
Add the
rtminput to your systemflake.nix, following yournixpkgs, which must have rustc 1.95 or later (nixos-26.05does). For a release, use one of the references above as itsurl. -
Add the packages to
environment.systemPackages(or tohome.packageswith Home Manager):{ inputs = { nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05"; rtm = { url = "github:brcha/rtm"; inputs.nixpkgs.follows = "nixpkgs"; }; }; outputs = { nixpkgs, rtm, ... }: { nixosConfigurations.myhost = nixpkgs.lib.nixosSystem { system = "x86_64-linux"; modules = [ ./configuration.nix ({ pkgs, ... }: { environment.systemPackages = with rtm.packages.${pkgs.stdenv.hostPlatform.system}; [ rtmapp rtmcli ]; }) ]; }; }; } -
Run
sudo nixos-rebuild switch --flake .#myhost, then start "Rusty Todo.txt Manager" from the application menu, or runrtmapporrtmcli --help.
macOS (Apple Silicon and Intel)
Universal binaries for macOS 11 (Big Sur) and later. They are signed ad hoc only, not with an Apple Developer ID, and not notarized, so Gatekeeper blocks them until you allow them.
Desktop app:
-
Download
rtmapp_<version>_universal.dmgand open it. -
Drag "Rusty Todo.txt Manager" to Applications.
-
Open the app from Applications. macOS 15 refuses with this dialog, which has no Open button:
“Rusty Todo.txt Manager” Not Opened
Apple could not verify “Rusty Todo.txt Manager” is free of malware that may harm your Mac or compromise your privacy.
Click Done. (Earlier macOS versions word the dialog differently.)
-
Open System Settings > Privacy & Security, scroll down to Security, and click Open Anyway next to the message about "Rusty Todo.txt Manager".
-
Authenticate, then click Open in the dialog that follows. Later launches open normally.
Instead of steps 3 to 5, you can remove the quarantine attribute in Terminal:
xattr -dr com.apple.quarantine "/Applications/Rusty Todo.txt Manager.app"
On macOS 14 and earlier, Control-click the app and choose Open also works; macOS 15 removed that shortcut.
The app's settings are in ~/Library/Application Support/rtm/config.toml.
CLI:
- Download
rtmcli-<version>-macos-universal.tar.gzand extract it:tar -xzf rtmcli-<version>-macos-universal.tar.gz. - Remove the quarantine attribute:
xattr -d com.apple.quarantine rtmcli("No such xattr" means there was none; carry on). - Move it to a directory on your
PATH, for examplesudo mkdir -p /usr/local/bin && sudo mv rtmcli /usr/local/bin/, or~/.local/binif that is on yourPATH. - Run
rtmcli --help.
Windows (x64)
The packages are unsigned, so Windows warns before running them.
Desktop app:
- Download
rtmapp_<version>_x64_en-US.msiand open it. - If SmartScreen shows "Windows protected your PC", click More info, then Run anyway.
- Follow the installer. It installs to
Program Filesand needs administrator rights: the UAC prompt shows "Unknown publisher"; click Yes. The Start Menu and desktop shortcuts can be deselected. - Start "Rusty Todo.txt Manager" from the Start Menu.
The installer replaces an installed older version, including the Tauri-based releases up to 0.1.3, and keeps its install folder.
CLI:
- Download
rtmcli-<version>-x64.exe. It is a portable binary; there is no installer. - Optionally rename it to
rtmcli.exe. - Move it to a folder on your
PATH, or add its folder toPATH: Start > "Edit environment variables for your account" >Path> Edit > New. - Open a new terminal and run
rtmcli --help.
ARM64 and 32-bit Windows builds are not currently produced.
Updates
The desktop app checks for a newer release a few seconds after it starts and once a day while it
runs. When one exists, a notice under the title bar offers it: Download opens the release's
page, where you download it as you did the first time; the × hides the notice until the next start.
rtmcli check-update does the same check on demand and prints the release's page; it is the only
rtmcli command that uses the network.
Each check is one request for https://rtm.brcha.com/releases.json, with no version or identifier,
so the website sees only your IP address. Turn the desktop app's check off in Settings ("Check
for updates", stored as check_for_updates = false in rtm/config.toml). To be offered beta
releases too, choose the Beta channel there (update_channel = "beta"), or run
rtmcli check-update --channel beta. The Nix packages have no update check; update them through
your flake inputs.