fa-blacklist

Source code for the app that adds blacklisting/whitelisting capabilities for everyone on the website FurAffinity.

Installation (browser add-on)

1. Download this repository's webext folder as a .zip file to your desktop and unzip it.
2. Choose for your browser:

• For Firefox, go to about:debugging#addons and click "Load Temporary Add-on" (yes, this is temporary, you may need to use the userscript instead).
• For Chrome, go to chrome://extensions, enable Developer mode, and click "Load Unpacked".
• For Opera, click on the Opera button and go to Extensions, click the Developer Mode button, and click "Load unpacked extension".
• For other browsers, consult a quick google search because I'm too lazy to list them here.

3. Open the manifest.json file, or load by selecting the directory.
4. Test it out! The extension remains until you close the browser or manually remove it from the same page as you installed it.

(Ignore manifest warnings: browsers may have conflicting strictness about its properties, but the end result makes no difference on the usage)

Installation (userscript)

1. Download the userscript from the 'raw' link (or click here).
2. Install (not in disabled state!).
3. You're done! Go onto FA and you'll see 'FA Blacklist' text on the topbar next to search. Click this to show the app's window interface. Many of the pages you see from the extension are also present in the window's tabs.

FA Blacklist 2: Electric Boogaloo

After what felt like an eternity of waiting, the FA Blacklist is finally back and better than ever.

This repo is split into both the WebExtension version and the Userscript version. There are advantages and disadvantages to both due to compatability across browsers, but generally, the WebExtension is better and more stable. That being said, there are some really really big changes I'd like to walk you through.

Multiple Interfaces

• The browser action pop-up
• The filter editor
• The options page
• Modifications to FurAffinity webpages
• The master list page (add-on only)

Browser Pop-up

The pop-up is part of the browser window, not the webpage, so it can be opened anywhere and anytime. The main purpose of the pop-up is to provide an entry point for the hidden other interfaces, such as the Editor and Options page, as well as display a clean list of your filters. All its functions include:

• You can click the power button in the pop-up to enable/disable the Extension (it turns grey)
• You can open the editor via +New Filter or by clicking the tag for any filter listed in the table
• You can open the options page via Options... to configure special settings for the extension
• You can search filters by name if you have lots of them
• You can organize the filters by ID, Name, Color, and Size

Each row of the filter list has a switch for enabling/disabling that filter and a delete button (with confirmation before actually removing).

Editor

The new filter editor is a huge upgrade from the original, and as a result, it needs its own web document. Changes include:

• Friendlier look, loadout, and tab updating
• Live preview of the filter's tag as you modify its name, color, and certain options
• Dropdown for the type of filter
• Color picker for the font
• Submissions textarea (yay!)
• Switch labels replace checkboxes so they're easier to click on and look vvvv nice

With the addition of filtering submissions individually, new options have arised. Auto-filtering has been expanded so that you can specify to match submissions, match usernames, and prefer which to filter.

As importing watchlists has been made possible again, so has importing galleries and favorites, thanks to FAExport.

Options

The options page is a quaint but useful webpage. It has undergone some changes from its predecessor, as follows:

• The Language selector, instantly translates the app to the language you select (only for the userscript, supports English and Russian so far).
• The Enable option, shared with the pop-up's "power button".
• The Always Scan option, which lets you control when to scan webpages for keywords. Checking this will let filters check the webpage every time you view it (whether loading or switching to the tab).
• The Automatically Sort option, kept from the original, causes the extension to sort the filter contents alphabetically.
• The Cleanup option, which is mostly a cosmetic fix for profile pages that hides the first submission and favorite.
• The Notification option, which enables browser notifications from the extension.
• The Censor option was removed to become compatible with the new interface programming. I may re-introduce this in the future.
• The Include Username option was moved to the filter editor and repurposed.
• A Reset button to return to default settings
• A Purge Data button, which will reset the app to its original factory state

Page Interface

When viewing webpages on FurAffinity, you'll notice a new option in the navbar called "Blacklist" with a familar icon next to it. Click it and you will see a windowed list of all the users and submissions found on the page that you can apply tags to. The window is draggable like before, but now has a top-right button to hide it.

You can see the newest addition to the interface by hovering over any user or submission on the page for a couple seconds. The window will update and narrow its list down to only the stuff relevant to what you hovered over. Pretty neat, huh?

Master List

As of 2.1.0, the Master List is a special page that lists all the users and submissions that are currently in filters. You have the advantage of editing tags off-site in the same fashion as on it. However, the initial loadout can be a heavy process.

This page is not available for the userscript.

Notes

1. It is 100% recommended not to use Internet Explorer or mobile browsers, as these tend to be far behind in the WebExtension standards. Other non-standard browsers such as Brave and Firefly may not have full support of features used in this app.

2. Running both the userscript and extension is a bad idea for the stability of both. Only run one at a time.

To-Do

I keep a to-do list of objectives that aren't required for the extension to work, but do add functionality that makes life easier. You can view the TODO.txt file to see what I have planned.

Contributing

I am in need of volunteers to help translate texts for localization. See _locales/en/messages.json for the English locales that need translating. If that isn't your thing, you're also free to help beta-test this extension for desktop and mobile.

These are all languages I would like to be translated (the list is not exhaustive, any locale is welcome):

• Spanish (es)
• French (fr)
• German (de)
• Portuguese (pt/pt-br)
• Chinese (zh/zh-cn)
• Japanese (ja)

Additionally, the full, un-minified source code for the userscript is available in the corresponding folder. Fell free to make whatever changes you want to it.

Feedback

Please send me your suggestions and bugs to the repo's issue inbox. If you have questions about the usage of certain interfaces, I'd be happy to help. Comments and criticisms about my work are welcome, too.