rstuven / opentweetfilter

A browser extension/add-on to filter tweets. Currently, supporting Google Chrome.and Mozilla Firefox (15+)

Open Tweet Filter

The open source browser extension to filter tweets.

If you have a lot of tweets filling your timeline about certain topic or person you are not interested in, this extension is for you. Or, as a user put it in a review, "Ahhhh, I no longer have to see intelligent people talk the same hive-minded shite about TV programs". :-)

Features:

• Filter out tweets by their contents or by their authors/retweeters.
• Filter out tweets using regular expressions (for example, match all words starting with "auto" using: /\Wauto/)
• Save your filters using bookmarklets.

Usage

1. Install the official release from Chrome Web Store or the latest version for Firefox or Safari from here.
2. Refresh you twitter.com page.
3. Select the Filters option in the gear icon drop down menu (just below "Lists" option).
4. Enter terms separated by commas in the first field.
5. Enter user names separated by commas in the second field.
6. Toggle Including / Excluding button before each field.
7. Toggle Show report of filtered tweets checkbox.
8. Toggle Enable / Disable button in the dialog footer.
9. Save the configuration as a bookmarklet. Just drag the OpenTweetFilter Settings box and drop it to the bookmarks bar, then you can rename it to describe the filters. You can create as many bookmarklets as you want.
10. Press Clear to reset all fields.

Feel free to experiment with the effect of all these settings. The tweets are not deleted but just hidden, so you can get them back any time by disabling the filter or changing the criteria.

NOTE: We respect your privacy, so no data is sent to any server. Your filters are processed in your computer and stored in your browser local storage (so please, use the bookmarklet feature or keep a copy of your filters in a safe place).

To suggest a feature, report a bug, or general discussion: http://github.com/rstuven/OpenTweetFilter/issues/

Development

1. Clone the repository

2. Install Node.js

3. Install dependencies

    npm install
   

4. Make some changes.

5. Build the extension:

    npm build
   

6. Builds can be slow. If you plan to make more changes, prefer:

   npm run watch

Chrome

1. Go to chrome://extensions/, activate Developer mode, then Load unpacked extension and select the build directory.

2. Disable the version installed from Chrome Web Store, if applies.

3. After every build, go to chrome://extensions/ and Reload (Ctrl+R) and refresh Twitter site.

Acknowledgements

Open Tweet Filter logo by @StoicYoic using Twitter Bird by ~freakyframes and Funnel Icon by IconEden.

License

Licensed under the MIT License Copyright 2012 Ricardo Stuven

opentweetfilter's Issues

Dialog does not appear if page is scrolled down

The centering calculation in DialogPhoenixView::toggleVisible is wrong.

Hide Filter button in pages like home (logged out), settings and help.

How to adapt the file 'messages.coffee' for Portuguese?

I would like to send a file 'messages.pt.coffee' to the src, but would need to adapt the 'messages.coffee' use this.

Can you help me to adapt it?

Thanks.

PS. Sorry for my bad English, I'm using a translator.

Close dialog using Escape key

It seems to stop working in Chrome

It does nothing in latest version of Chrome in OSX Sierra. It uses to work great!

Support Firefox

Show Filter button even if user is logged out

Settings export/import.

Provide a simple way to export/import settings. This could be an easier way to address the same problem than #2

Synchronize settings between windows

This feature existed in 1.*

Not working on Firefox 26.0

Hello,

This plugin is not working for me, the "filters" option does not appear when I click the gear icon (on twitter.com). Windows 7 64bits, Firefox 26.0.

Support Firefox again?

What happened to Firefox support?

Support Portuguese language

Portuguese is the third most used language among the extension web page visitors.

Specific word filtering

Whenever I filter out certain words, it also filters out separate words that contain that word when I'd really like to just filter out the word alone. For example, filtering out "ass" would also filter out "asset" or "assassin" etc. That's not the word I'm filtering, but it's the same concept. I've tried adding spaces around my word to indicate that it should be a standalone word, but it didn't work.

Is there a way to make it so that it only filters out the exact word? I've poked around but I haven't found any way to make this work, so I'd like an option perhaps similar to the /\W/ setting. People who like filtering out entire blocks of words can still do so, but if we want something more specific, we can have that. I'm not fully sure this is within the realm of possibility, but I'd really appreciate it if you could do something like it!

Filter dropdown does not appear in Mac Firefox 37

Other add-ons include Zotero, Buffer, Ghostery.

Button is not correctly located

button is not correctly located
http://goo.gl/kxkF5

Filter profiles

From "A Google User", Mar 6, 2011:
"E.g. you might have one group of keywords because you are trying to avoid hearing about a sporting result. But after it is over you want to relax that, but you might want to turn it on the following week with the same terms. I know you could just cut and paste and save them in a text file but...."

Not filtering tweets inside conversation modules

Regular Expressions not working

Unable to use regular expressions in filter. For example, my attempt to delimit by a whole word, does not work: e.g. \bLondon\b

Regular expressions support

Any term enclosed in slashes should be interpreted as a regular expression. For example, to filter all words starting with "auto":

/\Wauto/

Structured criteria

Items separated by commas, despite their simplicity, have some problems (eg. see #13) and limitatiosn (eg. not easy to implement #10). Structured criteria are more flexible and, hopefully, easier to use.

Support Safari

Icon for 'Filter' button

An icon instead of the "checkbox" would be nice.

Track extension usage

The objective is to design new features taking into account current usage patterns. Privacy is a concern, so we'll only track interaction events (eg. button clicks) and general statistics (eg. number of terms, min/max/avg term length), not actual filter terms data.

Google Analytics seems a good way to go: http://developer.chrome.com/extensions/tut_analytics.html
See also https://developers.google.com/analytics/devguides/collection/gajs/eventTrackerGuide

Support Chrome Sync

Opt-in sync support using chrome.storage API:
https://developer.chrome.com/extensions/storage

Add option to hide report view

Some users want to hide the report of how many tweets from which users are filtered. A checkbox in the settings dialog will make it.

Support "new new Twitter" (Phoenix T1)

Link to filters dialog in report view

"Hiding N tweets by... filter ...</>"

Access from top bar

From "A Google User", Feb 19, 2011:
"I would suggest adding a shortcut to the filter in the header on the New Twitter layout so that it is always accessible and I don't have to scroll to the top of the page to add a keyword filter."

Ability to Filter Tweets without links

I'd love the ability to filter Tweets without links. This includes Tweets with an image, but no link. Thus, the Tweet must have a link in order for it to visible.

Filtering session user

Filter tweets starting with @?

Yours hopefully,

Not able to save filter keywords in Mac Chrome 42 or access OTF Bookmark

Use "small" class in buttons

Not filtering mentions

Twitter update partially broke OpenTweetFilter

Twitter seems to have had a major user interface update for desktop users.
So much so that OpenTweetFilter is no longer filtering tweets.
I can still access the filter menu and add/remove keywords, etc..

Support new Twitter layout (Highline)

Close button styling isn't quite right

Hi there!

So this could be a conflict with another extension or something, but in the modal window that pops up for managing filters, The close button is a little wonky:

See the "x" over the "x"? That's what I mean.

This can be fixed by making sure .hidden-elements is set to display: none; in the CSS. Doesn't look like that's being set anywhere.

Thanks for a great extension!

Filter retweets of a user

Filter by author and also by "retweeter".

Bigger/Resizable input fields

From "A Google User", Oct 4, 2010:
"Suggestion : a way to have a bigger field to read the excluding terms (maybe using a textarea instead of a single input field?"

Filtering retweets not working

I've filtered particular users, but their retweets are still showing, which is a bit of a problem as I wanted to filter them because they retweet a lot of stuff. This is on Chromium Version 31.0.1650.63 Ubuntu 13.10 (31.0.1650.63-0ubuntu0.13.10.1~20131204.1)

Exceptions

From "A Google User", Feb 2, 2011:
"would be even better if you could define terms which won't be filtered no matter what."

External settings storage

Some users automatically clear the browser storage on exit, so a safe, private way to store settings externally is needed. Options are:

• Bookmarklet:
  • it could be easy to cover multiple profiles (see #8)
  • persistent locally (better than localStorage) and in the "cloud" (using Chrome "sign in").
• Google Docs API?
• another?