Automatically replaces the User-Agent with a randomized one.

Random User-Agent

Random User-Agent is an open-source MIT-licensed browser extension that is designed to replaces original browser User-Agent identifier (is a sort of "fingerprint") with a randomized. The extension is incredibly lightweight, using very few resources.

🔥 Features list

• Incredibly lightweight (~80KiB archived)
• Available in the official stores (chrome, firefox, edge, opera)
• Can automatically change the User-Agent after a specified period of time
• Change User-Agent on browser startup
• Replaces User-Agent HTTP header
• Protect against detection by JavaScript
• User-Agent randomization can be customized by the user (what browsers and OS are spoofed, etc.)
• Exceptions list (blacklist/whitelist) available with option of wildcards
• Allows using the remote User-Agents list
• Doesn't need initial setup - just install and forget about the real user-agent leaking

🛠 Where do I can test the functionality?

Open one of the links below with and without the extension enabled:

👀 Questions

Most questions can be answered by reading the issues. If the issues doesn't answer your question, open up a new discussion.

🧩 Install

Follow up by one of the links at the top 👆 of this page, or download CRX/XPI file directly the latest release from the releases page.

🖥️ Run Locally

After cloning the project, open the terminal and navigate to the project root directory (since I am a Linux adept, for the following commands installed docker and make are required):

$ make install # install all node dependencies

$ make watch # watch for source changes

$ make shell # start shell into a container with node

$ make build # build the extension

After make watch command you can:

1. Open chrome and navigate to extensions page using this URL: chrome://extensions
2. Make sure "Developer mode" is enabled
3. Click "Load unpacked extension" button, browse the ./dist directory and select it
4. Write something awesome (don't forget to make a PR after that)

📜 How to translate (localize) this extension?

...or fix translation mistakes. The translation process described here.

📡 Remote User-Agents list

Because the extension settings storage has size limitations - you don't have the option of keeping a large custom User-Agents list. Instead, you can place your list somewhere and link to it in the extension settings.

For example, you can create your own public repository/account on GitHub / GitLab / PasteBin / etc. and host your list on it.

The extension will send a GET request to the provided location URL. Supported list format is:

// will be ignored
 # will be ignored too

Mozilla/5.0 (Macintosh; Intel Mac OS X 11_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/93.0.4619.141 Safari/537.36
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/93.0.4593.122 Safari/537.36

// ...

🦾 Contributors

I want to say a big thank you to everyone who contributed to this project:

And a special thanks to @neroux - dude, you're awesome

🚀 Release

This note is for me, so as not to forget anything...

1. Make required changes in this repository, test it locally
2. Update changelog file and "publish" new release using repo releases page
3. When the CI process is done - download the file random-user-agent.zip to my computer
4. Open "Chrome Web Store Developer Dashboard" and click the "Upload new package" button, next, next... Publish
5. Download the main.crx file from the dashboard, rename it to the random-user-agent.crx and upload to the release on GitHub
6. Open "Mozilla add-on developer hub", "Select a file...", next, next, download the extension sources archive, upload it to hub, next, Publish
7. Download the random_user_agent_X.X.X-blabla.xpi file from the dashboard (after getting Approved status for the version), rename it to the random-user-agent.xpi and upload to the release on GitHub
8. Don't forget to update fkn edge and opera stores
9. Open a bottle of beer, I've earned