Skip to content

View dashboards and reports across your Mastodon resources using Steampipe.

License

Notifications You must be signed in to change notification settings

turbot/steampipe-mod-mastodon-insights

Mastodon Insights Mod for Steampipe

View Mastodon timelines, search hashtags, find interesting people, and check server stats.

Overview

Mastodon dashboards answer questions like:

  • Recent direct messages?
  • Recent notifications?
  • Recent toots on my home timeline?
  • On the local timeline?
  • On the federated timeline?
  • Recent toots on my lists?
  • Which toots are my favorites?
  • How many toots have I posted?
  • Of toots have I posted, how many are original vs boosts vs replies?
  • Who am I following (and which lists, if any, are they on)?
  • Who are my followers (and which lists, if any, are they on) ?
  • Which hashtags match science?
  • Which toots on the home timeline match federation?
  • Which accounts match alice?
  • Which accounts matching alice am I following, and/or followed by?
  • How many toots, logins, and registrations on my server in recent weeks?
  • How many more API calls can I make during this 5-minute cycle?

Getting started

Installation

Download and install Steampipe (https://steampipe.io/downloads). Or use Brew:

brew tap turbot/tap
brew install steampipe

Install the RSS plugin (which augments the Mastodon API)

steampipe plugin install rss

Install and configure the Mastodon plugin.

Clone:

git clone https://github.com/turbot/steampipe-mod-mastodon-insights
cd steampipe-mod-mastodon-insights

Tweak:

Edit mod.sp like so:

locals {
  host = "http://localhost:9194"
  server = "social.coop" // replace with your server
  ...
}


### Usage

Start your dashboard server:

```sh
steampipe dashboard

The dashboard launches at https://localhost:9194.

Credentials

This mod uses the credentials configured in the Steampipe Mastodon plugin.

Contributing

If you have an idea for additional dashboards or just want to help maintain and extend this mod (or others) we would love you to join the community and start contributing.

Please see the contribution guidelines and our code of conduct. All contributions are subject to the Apache 2.0 open source license.

About

View dashboards and reports across your Mastodon resources using Steampipe.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Languages