tootstream

github.com/magicalraccoon/tootstream Fediverse Open-source projectOpen source

Interact with Mastodon instances from the command line using tootstream.

github.com/magicalraccoon/tootstream
tootstream homepage screenshot

About tootstream

Tootstream is an open source command line interface written in Python 3 for using Mastodon instances from a terminal. Users install it with pip, start the program from a Python virtual environment, and type commands at a prompt. The project says it was inspired by Rainbowstream.

The tool supports OAuth and two-factor authentication. Login information for each instance is kept in a configuration file, and multiple instances or named profiles can be set up in that file. Network traffic goes through the requests library, so any proxy settings must use a format that library understands. The project notes that it relies heavily on Unicode fonts and suggests installing a specific font package on Ubuntu for the best display.

Key features

  • Command line interface for interacting with Mastodon instances
  • OAuth and two-factor authentication support
  • Multiple Mastodon accounts across instances using named profiles
  • Instance and profile selection through command-line parameters
  • Custom configuration file path set with the --config option
  • Proxy support through the requests library's environment settings
Best for: Python users and terminal-focused people who want to use one or more Mastodon accounts from a command line.
Good for
  • Open source under the MIT license
  • Supports OAuth and two-factor authentication
  • Can store and switch between accounts on multiple Mastodon instances
Watch out for
  • Requires Python 3
  • Stores login information for each instance in the configuration file
  • Relies heavily on Unicode fonts, and the project suggests a specific package on Ubuntu for the best experience

tootstream at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

tootstream alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in Fediverse

Well-known listings from the same topic.

All 113

tootstream FAQ

How is Tootstream installed?
The project lists installation with pip. Users create a Python 3 virtual environment, activate it, and run pip install tootstream. The development installation is done from a cloned repository.
Can I use more than one Mastodon account?
Yes. The --instance parameter sets the server location, and the --profile parameter selects a named profile. Each instance can have its own section in the configuration file.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing