https://github.com/stefanbohacek/mastodon-tools

Making Mastodon easier to use.
https://github.com/stefanbohacek/mastodon-tools

browser-extension chrome-extension firefox-extension mastodon

Last synced: 21 days ago
JSON representation

Making Mastodon easier to use.

• Host: GitHub
• URL: https://github.com/stefanbohacek/mastodon-tools
• Owner: stefanbohacek
• License: mit
• Created: 2023-03-07T19:49:30.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-02T19:16:25.000Z (10 months ago)
• Last Synced: 2025-03-26T21:08:12.111Z (about 1 month ago)
• Topics: browser-extension, chrome-extension, firefox-extension, mastodon
• Language: JavaScript
• Homepage: https://stefanbohacek.com/project/mastodon-tools-browser-extension/
• Size: 734 KB
• Stars: 20
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Mastodon Tools

**[Add to Firefox](https://addons.mozilla.org/en-US/firefox/addon/stefan-s-mastodon-tools/) | [Add to Chrome](https://chrome.google.com/webstore/detail/stefans-mastodon-tools/ngcnchkkkmneongkenppjocbfcoalfjn)**

You can also install the development version of this extension:

- [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExtension#installing)

- [Chrome](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked)

Feel free to [open a new issue](https://github.com/stefanbohacek/mastodon-tools/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) to report a bug or request a feature, or [reach out privately](https://stefanbohacek.com/contact/).

## Features

### Mastodon instance switcher

Clicking the extension icon lets you open a currently viewed post on another instance. On the extension settings you can specify one or more instances you use and want to switch between.

![Screenshot of the main menu with a list of Mastodon instances allowing you to switch between them.](browser-extension/assets/screenshot-popup.png)

Each instance domain (omit the http or https protocol) goes on a separate line.

![Screenshot of the settings page with a text field for adding your Mastodon instances.](browser-extension/assets/screenshot-settings.png)

### Expanded quote post previews

Quoted posts will now show the full text! (Shout out to [@mansr](https://society.oftrolls.com/@mansr) for [discovering how to do this](https://society.oftrolls.com/@mansr/112643547467281611)!)

![A side-by-side comparison of a quoted Mastodon post. On the left, the text is cut off. On the right, it is fully visible.](browser-extension/assets/expanded-quote-posts.png)

### Tag browser

When viewing a tag page on Mastodon, a link will be added to the plugin pop-up window that lets you browse the current tag across a larger portion of the fediverse using the [Fediverse Explorer](https://fediverse-explorer.stefanbohacek.dev/), another tool I've developed.

![Screenshot of the settings page with a text field for adding your Mastodon instances.](browser-extension/assets/tag-browser.png)

## Experimental features

### Profile hovercards

This feature is on [Mastodon's roadmap](https://joinmastodon.org/roadmap), under "Exploring" as "On-hover information cards for users", but you don't have to wait!

![A screenshot of two posts with the hovercard visible as an overlay.](browser-extension/assets/hovercard.png)

Note that this feature is under active development and you will need to enable it in the settings. It is currently only available in Chrome.

## Known issues

See also [open issues in this repo](https://github.com/stefanbohacek/mastodon-tools/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc).

### Profile hovercards

- Hovercards don't work for accounts with handles `[email protected]` if Mastodon itself is running at `subdomain.example.com`.

- Hovercards don't work for accounts on some non-Mastodon servers.

- Hovercards for accounts mentioned in profile bio are not positioned correctly.

## TODO

- ~~When data is not available, show profile picture from the post and a note explaining the lack of data.~~