/steampipe-mod-mastodon-insights

Primary LanguageSourcePawnApache License 2.0Apache-2.0

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

Usage

Start your dashboard server:

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.