Home

Awesome

<img src="source/icon.png" width="45" align="left">Refined Twitter

Browser extension that simplifies the Twitter interface and adds useful features

This project is not maintained anymore. Twitter rewrote their website and completely broke this extension, and it's much harder to reliably modify the new website. I also don't have time to fix these things and no one has stepped up to do so either. It had a great run. Thanks for all the love.

We use Twitter a lot and notice many dumb annoyances we'd like to fix. So here be dragons.

Install

Note: You must be logged in for this extension to work.

Highlights

You can configure many of these features in the extension settings.

Tip: Twitter has a native dark mode and you can toggle it using <kbd>Alt</kbd><kbd>m</kbd>. And press <kbd>Shift</kbd> <kbd>?</kbd> to see all keyboard shortcuts.

<img src="media/screenshot.gif" width="1272">

Customization

See the extension settings for what can be configured.

<img src="media/screenshot-settings.png" height="500">

We're happy to receive suggestions and contributions, but be aware this is an opinionated project. There's a high bar for adding options.

This doesn't necessarily limit you from manually disabling functionality that is not useful for you. Options include:

  1. (CSS Only) Use a Chrome extension that allows injecting custom styles into sites, based on a URL pattern. Stylus is one such tool. Example

  2. Clone the repository, make the adjustments you need, and load the unpacked extension in Chrome, rather than installing from the Chrome Store.

Contribute

Suggestions and pull requests are highly encouraged!

In order to make modifications to the extension you'd need to run it locally.

Please follow the below steps:

git clone https://github.com/sindresorhus/refined-twitter
cd refined-twitter
npm install    # Install dev dependencies
npm run build  # Build the extension code so it's ready for the browser
npm run watch  # Listen for file changes and automatically rebuild

Once built, load it in the browser of your choice:

<table> <tr> <th>Chrome</th> <th>Firefox</th> </tr> <tr> <td width="50%"> <ol> <li>Open <code>chrome://extensions</code> <li>Check the <strong>Developer mode</strong> checkbox <li>Click on the <strong>Load unpacked extension</strong> button <li>Select the folder <code>refined-twitter/distribution</code> </ol> </td> <td width="50%"> <ol> <li>Open <code>about:debugging#addons</code> <li>Click on the <strong>Load Temporary Add-on</strong> button <li>Select the file <code>refined-twitter/extension/manifest.json</code> </ol> </td> </tr> </table>

FAQ

Don't you have another extension with the same name?

This is reusing the name from the original Refined Twitter extension, which tried to use the mobile Twitter version on the desktop. It was a good idea in theory, but not in practice. This extension instead improves upon the desktop version of Twitter.

Will this extension work if I'm not logged in?

No.

Links

Related