Plugin for GreaseMonkey that adds filter buttons to reddit's /r/Europe submission overview pages (hot, new...) to filter out topics by key words. The script does nothing while viewing an individual thread, and the filter buttons will not be visible on individual thread pages.
Since the mods of /r/Europe do not believe in giving users the ability to filter unwanted topics, and since I was thoroughly fed up with how the recent flood of refugee-related links brought out the little bydlo in the normally well-behaved inhabitants of /r/Europe, I decided to code me a little filter. And while I was at it, open-source it so others could get at least some peace of mind as well.
It's not a predefined SJW package, you alone define what you want filtered out.
You need to run a relatively recent FireFox. It may or may not work on another browser like Opera, Safari, Internet Explorer or Chrome, but I never tested it on any of those and do not support them at all. Likewise it might work with another userscript plugin (like Stylish or dotjs), but I have never tried and do not care. It does not use any of Greasemonkey's API calls, so it would be easy to adapt.
Anecdotal reports tell me it works with Opera and Chrome and some userscript plugins.
If you have some extremely paranoid settings in your adblocker or other security add-on, you might need to allow local storage access so the filters survive a page reload.
Fire up your FireFox browser. You then need to install GreaseMonkey first and enable it.
- Navigate to the download link
- Firefox might present you with a yellow bar to ask for permission to download it. Give that permission.
- After downloading, there is a separate dialog asking for permission to install it. Click install
- A little smiling monkey informs you it has been installed. The skript is now active.
After installation, navigate to /r/europe on reddit. The script will only be active on that subreddit and will filter out any matching submissions on each page load. You'll notice a new button "Add Filter" right above "Europe".
If you click "Add Filter", a dialog appears where you can define a new filter.
The filter definition dialog has the following fields:
- Filter name: this is the name under which the filter will be listed on the /r/Europe page. You can pick any name you like
- Filter words: a comma separated lists of words which filter out submissions if they appear in the title. Don't use common words like "and" or a lot of submissions will be gone. If you want to filter out submissions dealing with Russia, use a list like
russia, russian, russians
, if you don't care about sports, useolympics, soccer, football, world cup
. The script does not distinguish between different capitalizations. - Filter action: leave this alone, you can only set "remove" at this point
- Filter color: color of the filter button. Leave empty and the script chooses a color.
If you want to know what keywords make up a certain filter, hover over it and a tooltip will appear with the filter words.
Click on the little cross in the dot on each filter button to remove this filter. Click on the filter to disable it - it will change to grey and the suppressed submissions will be visible again.
Removing filters comes without a confirmation dialog and cannot be undone. Filters keep their enabled/disabled state across page reloads.
- Works with RES, but does not support the "neverending Reddit" feature.
- Can only remove submissions, not highlight them or filter out other, not-matching submissions (like the category browser in /r/technology).
- No AND, OR or NOT functionality in filters.
- You can't edit a filter, you have to remove and re-define it.
- Filtering is strictly on headline keywords, no link flair filtering.
I wrote this for myself, therefore my support is extremely limited. I will ignore any one-line requests for help. Any requests that show the user did not do her homework will likewise be ignored. If you can't come up with a solid description of symptoms, I won't move my butt.
If you are able to use the issue tracker or even issue a pull request, you'll have a much higher chance to get my attention.