mastotool offers a collection of command-line tools to work with your Mastodon account
Go to file
Christian Muehlhaeuser 8404cea804
Disable CGO for goreleaser builds
2020-11-07 06:14:16 +01:00
.github Update GitHub workflow 2020-11-07 06:11:57 +01:00
.gitignore Added json backup files to .gitignore 2019-08-11 21:54:49 +02:00
.goreleaser.yml Disable CGO for goreleaser builds 2020-11-07 06:14:16 +01:00
LICENSE Initial commit 2018-11-22 04:23:24 +01:00 Add links to more builds to README 2020-10-06 04:15:37 +02:00
config.go Remove obsolete Config.Set return value 2020-08-23 12:09:26 +02:00
go.mod Bump dependencies to latest stable releases 2020-10-04 03:27:40 +02:00
go.sum Update goreleaser config 2020-10-04 10:26:47 +02:00
main.go Parse flags before accessing config 2020-10-06 04:07:43 +02:00
search.go Make progressBarWidth a const 2020-08-23 12:09:54 +02:00
stats.go Show helper text for empty tables 2020-08-23 12:10:03 +02:00


Latest Release Build Status Go ReportCard GoDoc

mastotool offers a collection of command-line tools to work with your Mastodon account





  • macOS with Homebrew: brew tap muesli/tap && brew install mastotool


  • Binaries for Linux, FreeBSD, OpenBSD, macOS & Windows

From source

Make sure you have a working Go environment (Go 1.9 or higher is required). See the install instructions.

Compiling mastotool is easy, simply run:

git clone
cd mastotool
go build


mastotool [command]

Available Commands:
  help        Help about any command
  search      searches your toots
  stats       generates statistics about your account

  -c, --config string   uses the specified config file (default "mastodon.json")
  -h, --help   help for mastotool

Use "mastotool [command] --help" for more information about a command.

Generate Statistics

mastotool stats [flags]

      --columns int   displays tables with N columns (default 80)
  -r, --recent int    only account for the N most recent toots (excl replies & boosts)
  -t, --top int       shows the top N items in each category (default 10)
mastotool search <string>


$ mastotool stats -r 100
Which instance to connect to:
Username (email): some_user@domain.tld
Password: ********

Loading toots for some_user     100 of 100 [############################>] 100.00%

Total toots: 100 (excluding replies & boosts)
Toots per day: 1.00 (account created 100 days ago)
Ratio toots/replies: 0.33
New followers per day: 7.41
New followings per day: 3.67
Likes per toot: 9.00 (total likes: 900)
Boosts per toot: 2.50 (total boosts: 250)
Replies per toot: 3.40 (total replies: 340)

Users you mentioned most                                              Interactions
abc                                                                              9
def                                                                              3

Users you boosted most                                                Interactions
xyz                                                                              7
zyx                                                                              2

Users that responded most                                             Interactions
def                                                                             11
fed                                                                              9

Most replied-to toots                                                      Replies
Some toot                                                                       20
Another toot                                                                     7

Most liked toots                                                             Likes
Some toot                                                                       50
Another toot                                                                     8

Most boosted toots                                                          Boosts
Some toot                                                                       10
Another toot                                                                     4

Highest scoring toots                                                        Score
Some toot                                                                       80
Another toot                                                                    20

Tags used that got the most likes                                            Likes
Some tag                                                                        10
Another tag                                                                      4

Tags used that got the most boosts                                          Boosts
Some tag                                                                         5
Another tag                                                                      1