FediAct/README.md

61 wiersze
4.3 KiB
Markdown
Czysty Zwykły widok Historia

2022-11-18 14:17:50 +00:00
# FediFollow
2022-11-18 14:37:47 +00:00
A Chrome/Firefox extension that simplifies following Mastodon users on other instances than your own by automatically redirecting you to your instance when pressing a follow button. The redirection is shortly indicated in the follow button itself and additional modals are blocked. Should work for other Chromium browsers too, as well as Kiwi browser on Android. It was tested with about 20 instances and supports different instance layouts/flavours. There are cases where it might fail (see notes and todos below). Additional features are planned.
2022-11-16 14:46:36 +00:00
## Installation
2022-11-18 14:17:50 +00:00
Right now, this needs to be installed in debugging / developer mode. Soon it will be available on Chrome Webstore / Firefox addon store.
2022-11-18 14:22:14 +00:00
1. Clone this repo or download it as ZIP (in this case, extract it somewhere)
2022-11-18 14:17:50 +00:00
### Chrome
2022-11-18 14:22:14 +00:00
2. Go to your Chrome extension page (URL: chrome://extensions) and enable developer mode
3. Click the "Load unpacked" button and then select the folder of the unpacked extension (should be "FediFollow-Chrome-main")
+ If you have a "Load ZIP" option you can also directly load the downloaded ZIP file
### Firefox
2. Open the debugging page (URL: about:debugging)
3. Select "This Firefox"
4. Click the "Load Temporary Add-on" button and then select the firefox.zip file in the folder you extracted earlier
2022-11-16 14:46:36 +00:00
## Setup
2022-11-17 14:37:08 +00:00
- Required: Click the extension icon to set your Mastodon instance
- Only set the domain name (like "infosec.exchange") without http/https or URL)
2022-11-17 21:42:12 +00:00
- Optional: Change whether to redirect in current or new tab
- Optional: Change the mode (all sites except those on blacklist (default) / no sites but those on whitelist)
2022-11-17 14:00:50 +00:00
- Optional: Add domain names to the blacklist/whitelist textarea, one per line, for ex.
```
2022-11-17 14:22:11 +00:00
mastodon.social
2022-11-17 14:00:50 +00:00
bbq.snoot.com
```
- Required: Hit "Submit" to update your settings
2022-11-16 14:46:36 +00:00
2022-11-18 14:34:50 +00:00
> **Note**
2022-11-18 16:39:38 +00:00
> 1. Currently supports different flavours of Mastodon 4 (3 should work too)
2022-11-18 16:41:14 +00:00
> 2. The whitelist mode can be useful if you do not want the extension to run basic checks on every site (since it needs to determine if it is a Mastodon site). Not sure if the blacklist feature is good for anything but I still included it.
> 3. It can have several reasons why a redirection/instance might not work:
> - You are not logged in to your home instance
2022-11-17 16:48:14 +00:00
> - There are instances that use custom layouts/flavours (additional identifiers need to be added to extension)
> - Instance chose to hide the follow button when not logged in (not supported yet)
> - It's not a Mastodon instance (not supported yet)
2022-11-17 16:48:14 +00:00
> - Element identifiers might change over time (extension needs to be updated)
2022-11-18 15:01:18 +00:00
> - Sometime, even if the handle is correct, a direct redirect to your instance can result in the page loading forever. This seems to be some caching issue / your instance has never seen this user. You need to copy the complete handle into the search in this case and open the profile from there. After that, the redirect will work like usual, since your instance has loaded the user once.
2022-11-17 16:48:14 +00:00
>
> So please be aware, that this extension can fail in some cases. Feel free to submit pull requests / issues.
2022-11-17 14:33:14 +00:00
2022-11-17 14:19:54 +00:00
## Screenshots
![Extension Popup](https://github.com/lartsch/FediFollow-Chrome/blob/main/img/screenshot1.PNG?raw=true)       
![Redirect Indication](https://github.com/lartsch/FediFollow-Chrome/blob/main/img/screenshot2.PNG?raw=true)
2022-11-18 00:35:27 +00:00
## Todos / Planned features
- Add support for post interactions
- Add support for other implementations (Plemora, GNU Social, ...)
- Publish to Chrome Webstore (IN PROGRESS)
2022-11-18 14:22:52 +00:00
- Publish to Firefox addon store
2022-11-17 16:48:14 +00:00
- Find additional layouts/flavours to add identifiers for
- Support for profiles views with follow button disabled
- Add support for Firefox (DONE)
2022-11-18 15:50:13 +00:00
- Fix some rare cases where an instance runs on a subdomain but the handle uses the domain without subdomain (need to get the handle directly from the profile instead of URL + domain name) (DONE)
- Add support for whitelist/blacklist (DONE)
2022-11-17 14:35:23 +00:00
- Add feature to indicate if you are already following a user when browsing his profile on another instance (this requires calls to the home instance, will look into it soon)
2022-11-18 14:24:55 +00:00
- Review if permissions in current manifest are actually needed like that (DONE)
2022-11-16 14:47:30 +00:00
- If I find myself to be bored, probably more
2022-11-18 14:36:35 +00:00
## Thanks to...
@raikasdev because I stole his fix for cross-browser storage API support