# Install topydo with Homebrew, apt, MacPorts, Nix

Todo list application using the todo.txt format. Version 0.16 via Homebrew; verified from local package data. Also installable with debian: sudo apt install topydo.

## Install

```sh
sudo av install brew:topydo
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install topydo
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install topydo
```

  Evidence: MacPorts ports tree: office/topydo/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install topydo
```

  Evidence: Debian stable package indexes: topydo from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#topydo
```

  Evidence: nixpkgs package indexes: pkgs/by-name/to/topydo/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:topydo
- **Package manager:** Homebrew
- **Version:** 0.16
- **Source summary:** Todo list application using the todo.txt format
- **Homepage:** <https://github.com/topydo/topydo>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- topydo (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.16
## Project history and usage

topydo is a console-oriented todo.txt application. Its README describes it as a powerful todo list application using the todo.txt format, with command-line, prompt, and column/TUI interfaces.

### Project history

The project sits in the todo.txt ecosystem rather than inventing its own database format. The README says its CLI was originally inspired by Gina Trapani's todo.txt CLI, while topydo adds native support for extensions such as due dates, start dates, dependencies, recurring items, sorting, grouping, aliases, and stable text-based identifiers.

The official documentation is published as a TiddlyWiki-style site, matching the project's hacker-friendly niche: a single-file text-task workflow with command references, configuration tiddlers, output format notes, and UI documentation.

### Adoption history

The input package facts show topydo packaged across Homebrew, Debian, MacPorts, Nix, and Ubuntu, which is broad for a console todo.txt tool. That distribution pattern reflects adoption by users who want a portable plain-text task file but prefer a richer Python CLI/TUI than the original shell-oriented todo.txt tools.

### How it is used

Typical use is to install with pip3, then run topydo in one of three interfaces: direct CLI commands, topydo prompt for a command loop, or topydo columns for a vim-like text UI with customizable columns. The README emphasizes that the todo.txt file remains compliant and can still be processed by other todo.txt tools.

Package nerds tend to care about topydo because it keeps the durable artifact as plain text while offering scriptable outputs such as iCalendar, JSON, and Graphviz Dot. That makes it useful for terminal-first personal workflows, backups, sync, and small automations without adopting a hosted task service.

### Why package nerds care

topydo is a representative package-manager-friendly productivity CLI: Python-based, plain-text-first, and interoperable with the wider todo.txt format. Its significance is strongest for users who value editable files, Unix-style tool chaining, and terminal UI ergonomics.

### Timeline

- Project docs: Official README presents topydo as a todo.txt-compatible application with CLI, prompt, and column modes.
- Package adoption: Input package facts list Homebrew, Debian, MacPorts, Nix, and Ubuntu packages.
- Current docs: Official documentation is published at topydo.github.io/topydo as a TiddlyWiki containing command, configuration, output, and UI topics.

### Related projects

- The README links the todo.txt format and Gina Trapani's todo.txt CLI as direct context, and also references bram85/todo.txt-tools.

### Sources

- <https://github.com/topydo/topydo#readme>
- <https://topydo.github.io/topydo>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Other Package-Manager Records

- Debian apt - topydo - 0.15+dfsg1-1: normalized package name match | Debian stable package indexes: topydo from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | advanced todo.txt terminal utility for managing tasks | https://github.com/topydo/topydo
- Nix - topydo: normalized package name match | nixpkgs package indexes: pkgs/by-name/to/topydo/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - topydo - 0.14-5.2: normalized package name match | Ubuntu 24.04 LTS package indexes: topydo from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | advanced todo.txt terminal utility for managing tasks | https://github.com/topydo/topydo
- MacPorts - topydo: normalized package name match | MacPorts ports tree: office/topydo/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/topydo.yml](https://github.com/mxcl/pkgdb/blob/main/combined/topydo.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph