macOS
Homebrewverified · 100%
brew install tootlocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install tootMacPorts ports tree · net/toot/Portfile · source: api.github.com
brew / rank 3231
Install toot with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman
Mastodon CLI & TUI. Version 0.52.1 via Homebrew; verified 2026-07-10. Also installable with debian: sudo apt install toot.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add tootAlpine Linux edge package indexes · toot · source: dl-cdn.alpinelinux.org
Debian aptverified · 92%
sudo apt install tootDebian stable package indexes · toot · source: deb.debian.org
Fedora dnfverified · 92%
sudo dnf install tootFedora Rawhide package metadata · toot · source: dl.fedoraproject.org
Nixverified · 92%
nix profile install nixpkgs#tootnixpkgs package indexes · pkgs/by-name/to/toot/package.nix · source: api.github.com
Arch Linux pacmanverified · 92%
sudo pacman -S tootArch Linux sync databases · toot · source: geo.mirror.pkgbuild.com
overview
Package summary
Mastodon CLI & TUI
Project links
Commands and aliases
- toot
history
Project history and usage
toot is a Python command-line and terminal UI client for Mastodon and compatible Fediverse servers. It belongs to the long-running niche of social-network clients for people who prefer shell workflows, scriptable commands, and terminal timelines over a browser.
Project history
PyPI release history starts with toot 0.1.0 on April 12, 2017, soon after Mastodon became a visible open-source social-networking project. The official documentation describes toot as both a CLI and TUI for interacting with Mastodon-compatible instances from the command line.
The project grew from posting and timeline commands into a broader Fediverse client. The 2023 changelog records the documentation move from Read the Docs to toot.bezdomni.net, later releases added settings, shell completion, JSON output, account and list features, richer TUI behavior, image display, poll support, timeline command groups, and follow-request commands.
Adoption history
The official installation page says toot is packaged for various platforms and recommends using the operating system package manager when possible. It also documents Homebrew for macOS users, pipx for Python-oriented installs, and source installs from the GitHub release archive. The input package metadata additionally shows packaging in Homebrew, Debian, Ubuntu, Fedora, Alpine, Arch, MacPorts, and Nix.
How it is used
The basic workflow starts with `toot login`, which stores application and user access tokens in `~/.config/toot/config.json`. Users can then post statuses from arguments, pipes, files, or an editor, view timelines, manage accounts, and use the TUI with keyboard shortcuts for navigation, boosting, replying, editing, bookmarking, media viewing, and JSON inspection.
Why package nerds care
toot matters in the package-nerd niche because it makes a social network behave like a Unix program: installable from distro or language package managers, configurable under XDG-style paths, scriptable in shell pipelines, and usable in terminals on servers or minimal desktops.
Timeline
- 2017: First PyPI release, 0.1.0.
- 2023: Documentation moved to toot.bezdomni.net.
- 2023: 0.38.0 added a settings file and more TUI timeline support.
- 2024: 0.40.0 moved command handling to Click and added shell completion and environment-variable support.
- 2025: 0.48.0 introduced the `toot timelines` command group.
- 2026: 0.52.1 published on PyPI.
Related projects
- Mastodon, Fediverse-compatible servers, Pleroma, GoToSocial, snac2, pipx, Homebrew.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for toot. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Linux
~/.config/toot/settings.toml- Windows
%APPDATA%\toot\settings.toml
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
~/.config/toot/config.json
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
toot | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version0.52.1
manager updated2026-07-10
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:toot |
|---|---|
| Version | 0.52.1 |
| Package manager | Homebrew |
| Homepage | https://toot.bezdomni.net/ |
| Repository | https://github.com/ihabunek/toot |
| Last updated | 2026-07-10T11:42:37Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Debian apt95%
toot 0.48.1-0
mastodon cli client
https://github.com/ihabunek/toot
sudo apt install toot- Section: web
- Architecture: all
- 8 dependencies
- 1 optional deps
- normalized package name match
- Matched by: Toot
Nix95%
toot
nix profile install nixpkgs#toot- normalized package name match
- Matched by: Toot
Ubuntu apt95%
toot 0.41.1-1
mastodon cli client
https://github.com/ihabunek/toot
sudo apt install toot- Section: universe/web
- Architecture: all
- 7 dependencies
- normalized package name match
- Matched by: Toot
apk95%
toot 0.52.1-r0
mastodon cli & tui
https://github.com/ihabunek/toot
sudo apk add toot- License: GPL-3.0-only
- Architecture: x86_64
- Source Package: toot
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Toot
apk95%
toot-pyc 0.52.1-r0
Precompiled Python bytecode for toot
https://github.com/ihabunek/toot
sudo apk add toot-pyc- License: GPL-3.0-only
- Architecture: x86_64
- Source Package: toot
- 1 dependencies
- normalized package name match
- Matched by: Toot
dnf95%
toot 0.51.1-1.fc45
A CLI and TUI tool for interacting with Mastodon
https://github.com/ihabunek/toot
sudo dnf install toot- License: GPL-3.0-only
- Category: Unspecified
- Architecture: noarch
- Source Package: toot
- 3 dependencies
- 3 provides
- normalized package name match
- Matched by: Toot
pacman95%
toot 0.52.1-1
A Mastodon CLI client
https://github.com/ihabunek/toot
sudo pacman -S toot- License: GPL-3.0-only
- Architecture: any
- 11 dependencies
- 2 optional deps
- normalized package name match
- Matched by: Toot
MacPorts95%
toot
sudo port install toot- normalized package name match
- Matched by: Toot
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation