Install Todobar on Windows and macOS

Installing Todobar takes just a few steps. You download a release artifact from GitHub, run the installer for your platform, and the app starts on first launch. There is no account setup and no configuration required before you see the sidebar for the first time. Go to the GitHub Releases page and download the file that matches your platform. The current stable release is v0.1.5.

Windows
macOS

Windows users can choose between a standard setup executable and an MSI installer for managed deployments.

Download the installer

From the Releases page, download Todobar_<version>_x64-setup.exe. If your environment requires an MSI, download Todobar_<version>_x64_en-US.msi instead.

Run the installer

Double-click the .exe file and follow the on-screen prompts. The NSIS installer places Todobar in your user’s application folder and creates a start menu entry.

Launch Todobar

Todobar starts automatically after installation and appears as a small handle on the right edge of your screen. You will also see a tray icon in the system tray.

Toggle the sidebar

Click the edge handle, or press Alt+T from any app, to open the task panel. Press Esc or Alt+T again to close it.

The Windows release is built locally and in GitHub Actions. It is the most thoroughly tested platform at this stage.

macOS users download a .dmg disk image. Choose the file that matches your chip.

Todobar’s macOS builds are currently unsigned. Apple Developer code signing and notarization are not yet configured. macOS Gatekeeper will block unsigned apps from opening with a double-click. Follow the right-click workaround in step 3 below.

Download the correct .dmg

From the Releases page:

Apple Silicon (M1/M2/M3/M4): download Todobar_<version>_aarch64.dmg
Intel Mac: download Todobar_<version>_x64.dmg

If you are unsure which chip your Mac has, go to Apple menu → About This Mac. “Apple M” in the chip line means Apple Silicon.

Open the disk image

Double-click the downloaded .dmg file to mount it. A Finder window opens showing the Todobar app.

Work around Gatekeeper

Because the app is unsigned, macOS will refuse to open it with a normal double-click. Instead:

Right-click (or Control-click) the Todobar app icon.
Choose Open from the context menu.
Click Open again in the dialog that appears.

You only need to do this once. Subsequent launches work normally.

Move to Applications (optional)

Drag Todobar from the disk image window into your Applications folder so it is available from Spotlight and Launchpad.

Launch and toggle

Open Todobar from your Applications folder or Spotlight. The sidebar handle appears at the right screen edge and a menu-bar icon appears at the top. Press Alt+T (or Option+T on Mac keyboards) from any app to toggle the panel.

macOS builds are compiled in CI on GitHub-hosted runners. Package quality is verified, but physical device QA on real hardware is still in progress. Signing and notarization are planned for a future release.

After installation

Once Todobar is running, the edge handle is visible on your screen. From there you can:

Click the handle to open and close the panel.
Drag the handle along the docked edge to reposition it.
Use the tray icon (Windows) or menu-bar icon (macOS) to toggle Todobar, open Settings, or quit.
Open Settings from the command rail to change the dock edge, theme, panel width, and other preferences.

See the quickstart guide for a walkthrough of your first session.

Get Started

Using Todobar

Customization

Development

Reference

Install Todobar on Windows and macOS

After installation

Build docs developers (and LLMs) love

Get Started

Using Todobar

Customization

Development

Reference

Documentation Index

​After installation

Build docs developers (and LLMs) love

After installation