Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/turbot/steampipe-mod-mastodon-insights
View dashboards and reports across your Mastodon resources using Steampipe.
https://github.com/turbot/steampipe-mod-mastodon-insights
maslowcreate sql steampipe steampipe-mod
Last synced: about 2 months ago
JSON representation
View dashboards and reports across your Mastodon resources using Steampipe.
- Host: GitHub
- URL: https://github.com/turbot/steampipe-mod-mastodon-insights
- Owner: turbot
- License: apache-2.0
- Created: 2022-11-13T06:51:24.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-09-26T07:02:42.000Z (over 1 year ago)
- Last Synced: 2024-04-14T22:52:07.652Z (9 months ago)
- Topics: maslowcreate, sql, steampipe, steampipe-mod
- Language: HCL
- Homepage:
- Size: 133 KB
- Stars: 11
- Watchers: 9
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```sh
brew tap turbot/tap
brew install steampipe
```
Install the RSS plugin (which [augments](https://blog.jonudell.net/2022/12/06/mastodon-steampipe-and-rss/) the Mastodon API)
```sh
steampipe plugin install rss
```
Install and configure the [Mastodon plugin](https://github.com/turbot/steampipe-plugin-mastodon).
Clone:
```sh
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](https://github.com/turbot/steampipe-plugin-mastodon).
## Contributing
If you have an idea for additional dashboards or just want to help maintain and extend this mod ([or others](https://github.com/topics/steampipe-mod)) we would love you to join the community and start contributing.
- **[Join #steampipe on Slack →](https://turbot.com/community/join)** and hang out with other Mod developers.
Please see the [contribution guidelines](https://github.com/turbot/steampipe/blob/main/CONTRIBUTING.md) and our [code of conduct](https://github.com/turbot/steampipe/blob/main/CODE_OF_CONDUCT.md). All contributions are subject to the [Apache 2.0 open source license](https://github.com/turbot/steampipe-mod-digitalocean-insights/blob/main/LICENSE).