Skip to content

Latest commit

 

History

History
223 lines (137 loc) · 8.38 KB

README.md

File metadata and controls

223 lines (137 loc) · 8.38 KB

icon Tab Modifier

GitHub Release license GitHub Actions Workflow Status .nvmrc yarn:required Conventional Commits pr welcome

Take control of your tabs.

Features

  • Rename tab
  • Change tab icon
  • Pin tab
  • Group tabs
  • Prevent tab closing
  • Unique tab
  • Mute tab

Quick rename can be done by right-clicking anywhere in the page and click on "Rename Tab".

Installation

Tab Modifier is compatible with Chromium-based browsers.

Browser Install Link Web Store
Google Chrome ⬇️ Install Chrome Web Store
Arc ⬇️ Install Chrome Web Store
Brave ⬇️ Install Chrome Web Store
Opera ⬇️ Install Opera Addons
Microsoft Edge ⬇️ Install Microsoft Edge Addons

Firefox and Safari are not available.

Usage

  • Click on the Tab Modifier icon icon to open Popup or Right-Click then Options.
  • Create your tab rules.
  • Try & enjoy!

Why did you build this extension?

I needed a quick UI element in Chrome to know the environment of the tab, as a Web developer I often use multiple versions of the same website: local, pre-production and production.

Not easy to find the appropriate tab when you have multiple tabs called "My awesome website".

I created Tab Modifier to add prefixes to website titles with a specific match.

  • [DEV] My awesome website: .local.domain.com
  • [PREPROD] My awesome website: .preprod.domain.com
  • [PROD] My awesome website: .domain.com

After that, I have added more features like "auto-pin", custom favicons and more.

Core system

Tab Modifier is based on user rules and act on the tab URL that matches the first seen rule. When you open a tab (or refresh), the extension will check if the URL matches a rule and apply the actions.

Aware of that, there is no reason to include a feature that is not "rule-based". Prefer to install specific extensions or create your own.

Examples

You have infinite possibilities, here are some configurations:

Pin all tabs:

  • Detection: Contains
  • URL fragment: http
  • Pinned: ON

Say hello to all Google websites:

  • Detection: Contains
  • URL fragment: google.com
  • Title: Hello Google: {title}

❌ Disguise GitHub as Google

This will not work due to Content Security Policy (CSP) restrictions:

Refused to load the image 'https://www.google.com/favicon.ico' because it violates the following Content Security Policy directive from GitHub".

❌ Prevent accidental tab closure:

  • Detection: Contains
  • URL fragment: important-website.com
  • Protected: ON

This feature is only available if you interact with the page at least once due to Chrome's security restrictions. https://developer.mozilla.org/en-US/docs/Web/API/Window/beforeunload_event#usage_notes

Mute all Youtube videos by default:

  • Detection: Contains
  • URL fragment: youtube.com
  • Mute: ON

Set blank icon on Pinterest:

  • Detection: Contains
  • URL fragment: pinterest.fr
  • Icon: select "Chrome > Default"

Get only one GMail tab opened at once:

Pin all PNG images (useless):

  • Detection: Ends with
  • URL fragment: .png
  • Pinned: ON

Customize title with HTML selector and Regexp:

  • Detection: Contains
  • URL fragment: github.com
  • Title: {title} | $2 by $1
  • URL matcher: github[.]com/([A-Za-z0-9_-]+)/([A-Za-z0-9_-]+)

Tab title will be: "FuryBee/chrome-tab-modifier: Take control of your tabs | chrome-tab-modifier by furybee"

❌ Match GitHub repositories:

  • Detection: RegExp
  • URL fragment: github[.]com/([A-Za-z0-9_-]+)/([A-Za-z0-9_-]+)
  • Title: I got you GitHub!

Customize GMail title with Title matcher and URL matcher:

  • Detection: Contains
  • URL fragment: mail.google.com
  • Title: @0 | $0
  • Title matcher: [a-z]*@gmail.com
  • URL matcher: [a-z]*.google.com

Tab title will be: "[email protected] | mail.google.com"

Github filename as title for blobs:

  • Detection: RegExp
  • URL fragment: github[.]com/([A-Za-z0-9_-]+)/([A-Za-z0-9_-]+)/blob/
  • Title: {#file-name-id-wide}

And now, build your own... 💪

Known issues

Local icon path doesn't work

Related issue: #5

Due to browser security restrictions, this path won't work: file://<path>/icon.png. Your icon will not be shown by Chrome.

Alternatively, you can upload your icon somewhere like imgur.com and paste the direct link in your rule.

Another solution consists in transform your image in the Data URI format. Go to ezgif.com and paste the given output (the long text) in the icon input on your rule.

Chrome system pages chrome://

Related issues: #11, #14

Pages that start with chrome:// URL are protected. No content script can be injected then Tab Modifier will not work on these pages.

Local files file:///

Related issue: #13

By default, extensions don't have access to local files. You have to opt-in "Allow access to file URLs" from chrome://extensions/?id=hcbgadmbdkiilgpifjgcakjehmafcjai.

Protected action is not triggered

Related issue: #95

Since Chrome 90, the JS event that triggers a refresh or a closure has been reworked. See related issue.

Development

In case you want to contribute or just want to play with the code, follow the guide.

Setup

Download and install NodeJS v18 to get npm.

💡 Use nvm to allow you to quickly install and use different versions of node via the command line.

Install yarn globally:

npm install -g yarn

Clone the project and install dependencies with yarn.

Type yarn dev to watch your changes inside src/ folder or type yarn build after each change.

Load local extension in Chrome

Go to chrome://extensions/ and enable the "Developer mode".

Click on "Load unpacked extension..." and select the project dist/ folder.

Donation

A huge thanks to all donators!

If you like this extension and want to support its development, you can make a donation by clicking one of the links below.

License

See license file.