mastotool offers a collection of command-line tools to work with your Mastodon account
Go to file
dependabot[bot] 43a1766244 Bump actions/setup-go from 3 to 4
Bumps [actions/setup-go](https://github.com/actions/setup-go) from 3 to 4.
- [Release notes](https://github.com/actions/setup-go/releases)
- [Commits](https://github.com/actions/setup-go/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/setup-go
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
2023-03-16 11:04:20 +01:00
.github Bump actions/setup-go from 3 to 4 2023-03-16 11:04:20 +01:00
.gitignore Added json backup files to .gitignore 2019-08-11 21:54:49 +02:00
.golangci-soft.yml ci: add linters 2022-11-15 18:38:02 +01:00
.golangci.yml ci: add linters 2022-11-15 18:38:02 +01: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
README.md Fix goreportcard badge 2021-05-19 06:46:50 +02:00
config.go fix: linter errors 2022-11-15 18:38:02 +01:00
go.mod Bump github.com/jedib0t/go-pretty/v6 from 6.4.3 to 6.4.4 2023-02-01 01:05:51 +01:00
go.sum Bump github.com/jedib0t/go-pretty/v6 from 6.4.3 to 6.4.4 2023-02-01 01:05:51 +01:00
main.go Parse flags before accessing config 2020-10-06 04:07:43 +02:00
search.go fix: linter errors 2022-11-15 18:38:02 +01:00
stats.go fix: linter errors 2022-11-15 18:38:02 +01:00

README.md

mastotool

Latest Release Build Status Go ReportCard GoDoc

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

Installation

Packages

Linux

macOS

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

Binaries

  • 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 https://github.com/muesli/mastotool.git
cd mastotool
go build

Usage

mastotool [command]

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

Flags:
  -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]

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>

Example

$ mastotool stats -r 100
Which instance to connect to: https://mastodon.social
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