Random User-Agent and Switcher

😎 Browser extension that automatically replaces the User-Agent with a randomized one

View the Project on GitHub tarampampam/random-user-agent


Automatically replaces the User-Agent with a randomized one.

Chrome Web Store   Firefox Add-ons   Edge Addons   Opera Addons

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


🔥 Features list

📷 Screenshots

Popup General settings Generator settings Blacklist settings
popup general generator blacklist

🧩 Installation

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

🛠 Where do I can test the functionality?

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

Resource Test
What is my User Agent ✅ 3 Passed / ❌ 3 Failed
Browser Information (BrowserSPY) ✅ Passed
whoer ✅ Passed
Browser Leaks ✅ Passed
Device Info ✅ Passed
CreepJS ❌ Failed

📡 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

// ...

📜 How to translate (localize) this extension?

…or fix translation mistakes. The translation process described here (related issue).

👀 Questions

Most questions can be answered by reading the issues. If the issues doesn’t answer your question, open up a new discussion. If you find a bug or have a feature request, please file a new issue.

This extension may actually be making users more uniquely fingerprintable, not less?

Faking your user agent might make you more fingerprintable, not less. There are ways other than User-Agent sniffing to determine what browser you’re using, so malicious sites could learn what browser you’re really using through other means and then combine that with your randomly changing User-Agent to pretty effectively track you. For background, see this GitHub issue.

Hotkeys on some sites no longer work, why?

This may occur because your User-Agent simulates MacOS - in this case, some websites make an attempt to handle ⌘ cmd key instead of the ctrl. For fixing this issue just disable MacOS User-Agent in the extension generator settings.

Are keyboard shortcuts supported?

Sure - user-agent renewal (Ctrl+Shift+U by default). You can change it in your browser settings: chrome://extensions/shortcuts (in Google Chrome).

How to install it on Firefox Mobile?

Following this guide you need to specify a collection ID to install the addon:

image image

Enter 14112060 / rua. After you tap “OK”, the application will close and restart.

🖥️ 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)

🦾 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

🛡 Privacy Policy

Random User-Agent had never collected and will never collect any personal data, browsing history etc.

Full privacy policy text can be found here.

🚀 How to publish a 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