{"id":15116727,"url":"https://github.com/tarampampam/random-user-agent","last_synced_at":"2025-05-15T07:07:11.795Z","repository":{"id":2950252,"uuid":"65311086","full_name":"tarampampam/random-user-agent","owner":"tarampampam","description":"😎 Browser extension that automatically replaces the User-Agent with a randomized one","archived":false,"fork":false,"pushed_at":"2025-05-01T14:28:08.000Z","size":3491,"stargazers_count":658,"open_issues_count":20,"forks_count":72,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-05-13T04:40:25.123Z","etag":null,"topics":["browser-extension","chrome-extension","firefox-extension","switcher","typescript","user-agent"],"latest_commit_sha":null,"homepage":"https://random-user-agent.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tarampampam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-09T16:33:46.000Z","updated_at":"2025-05-09T10:57:31.000Z","dependencies_parsed_at":"2023-02-17T03:31:16.692Z","dependency_job_id":"ec6c70b7-0b4a-4a29-8a95-64072f104ac0","html_url":"https://github.com/tarampampam/random-user-agent","commit_stats":{"total_commits":646,"total_committers":20,"mean_commits":32.3,"dds":0.541795665634675,"last_synced_commit":"5a6b84da9f9fe07ed560038e017447a721d32566"},"previous_names":[],"tags_count":54,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frandom-user-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frandom-user-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frandom-user-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frandom-user-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tarampampam","download_url":"https://codeload.github.com/tarampampam/random-user-agent/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254292042,"owners_count":22046426,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-extension","chrome-extension","firefox-extension","switcher","typescript","user-agent"],"created_at":"2024-09-26T01:44:33.378Z","updated_at":"2025-05-15T07:07:06.787Z","avatar_url":"https://github.com/tarampampam.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"84\" alt=\"logo\" src=\"https://bit.ly/3wxyYtf\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  Automatically \u003cstrong\u003ereplaces the User-Agent\u003c/strong\u003e with a \u003cstrong\u003erandomized one\u003c/strong\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://bit.ly/4dCzvut\"\u003e\u003cimg alt=\"chrome\" src=\"https://img.shields.io/chrome-web-store/v/einpaelgookohagofgnnkcfjbkkgepnp.svg?style=for-the-badge\u0026cacheSeconds=120\u0026logo=google-chrome\u0026label=google%20chrome\u0026logoColor=white\" /\u003e\u003c/a\u003e \u0026nbsp;\n  \u003ca href=\"https://mzl.la/4dHvNzH\"\u003e\u003cimg alt=\"firefox\" src=\"https://img.shields.io/amo/v/random_user_agent.svg?style=for-the-badge\u0026cacheSeconds=120\u0026logo=firefox-browser\u0026label=firefox\u0026logoColor=white\" /\u003e\u003c/a\u003e \u0026nbsp;\n  \u003ca href=\"https://bit.ly/3V0biH7\"\u003e\u003cimg alt=\"edge\" src=\"https://img.shields.io/badge/Edge-555555.svg?\u0026style=for-the-badge\u0026logo=microsoft-edge\u0026logoColor=white\" /\u003e\u003c/a\u003e \u0026nbsp;\n  \u003ca href=\"https://bit.ly/3Vb8PtT\"\u003e\u003cimg alt=\"opera\" src=\"https://img.shields.io/badge/Opera-555555.svg?\u0026style=for-the-badge\u0026logo=opera\u0026logoColor=white\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  Random User-Agent is an \u003cstrong\u003eopen-source\u003c/strong\u003e MIT-licensed \u003cstrong\u003ebrowser extension\u003c/strong\u003e that is\n  designed to replace the original browser User-Agent identifier (is a sort of \"fingerprint\") with a randomized\n  (based on your preferences).\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://bit.ly/3Vb8PtT\"\u003e\u003cimg alt=\"opera\" src=\"https://bit.ly/44KOhLB\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## 🔥 Features list\n\n- Incredibly lightweight (`~150KiB` archived)\n- Available in the official stores ([Chrome][link-chrome-store], [Firefox][link-ff-store], [Edge][link-edge-store], [Opera][link-opera-store])\n- Can automatically change the User-Agent after a specified period of time\n- Change User-Agent on browser startup\n- Replaces the `User-Agent` HTTP header\n- Protection against detection by JavaScript\n- User-Agent randomization can be customized by the user (specifying spoofed browsers and OS, etc.)\n- Exceptions list (blacklist/whitelist) available\n- Allows the use of a remote User-Agents list\n- No initial setup needed - just install and forget about the real user-agent leaking\n\n[link-chrome-store]:https://bit.ly/4dCzvut\n[link-ff-store]:https://mzl.la/4dHvNzH\n[link-edge-store]:https://bit.ly/3V0biH7\n[link-opera-store]:https://bit.ly/3Vb8PtT\n\n\u003e [!NOTE]\n\u003e 🐞 If you encounter a **bug** with the extension but don't have a GitHub account (and prefer not to register for one), feel free to email it to [`bugreport@random-user-agent.com`](mailto:bugreport@random-user-agent.com) along with details about how to reproduce the bug, your operating system, and browser. Thank you!\n\n## 🧩 Installation\n\nFollow up by one of the links at the top 👆 of this page, or download `CRX` ([link][latest-crx]) / `XPI`\n([link][latest-xpi]) file directly from the latest release from the [releases page][releases].\n\n[releases]:https://github.com/tarampampam/random-user-agent/releases\n[latest-crx]:https://github.com/tarampampam/random-user-agent/releases/latest/download/random-user-agent.crx\n[latest-xpi]:https://github.com/tarampampam/random-user-agent/releases/latest/download/random-user-agent.xpi\n\n## 🛠 Where do I can test the functionality?\n\nOpen one of the links below both with and without the extension enabled:\n\n| Resource                                            |          Test           |\n|-----------------------------------------------------|:-----------------------:|\n| [What is my User Agent][test-webbrowsertools]       | ✅ 5 Passed / ❌ 1 Failed |\n| [vytal scan][test-vytal]                            | ✅ 2 Passed / ❌ 1 Failed |\n| [whoer][test-whoer]                                 |        ✅ Passed         |\n| [Browser Leaks][test-browserleaks]                  |        ✅ Passed         |\n| [Device Info][test-deviceinfo]                      |        ✅ Passed         |\n| [CreepJS][test-creepjs]                             |        ✅ Passed         |\n\n[test-webbrowsertools]:https://webbrowsertools.com/useragent/\n[test-whoer]:https://whoer.net/\n[test-browserleaks]:https://browserleaks.com/javascript\n[test-deviceinfo]:https://www.deviceinfo.me/\n[test-creepjs]:https://abrahamjuliot.github.io/creepjs/\n[test-vytal]:https://vytal.io/scan\n\n## 📡 Remote User-Agent List\n\nDue to size limitations in the extension settings storage, you are unable to keep a large custom User-Agent list\ndirectly within the extension. Instead, you can host your list elsewhere and provide a link to it in the extension\nsettings.\n\nFor example, you can create your own public repository/account on [GitHub Gist](https://gist.github.com/),\n[GitLab](https://gitlab.com/), or similar platforms, and host your list there.\n\nThe extension will send a `GET` request to the provided URL location. The supported list format is as follows:\n\n```text\n// Comments like this will be ignored\n # Comments prefixed with '#' will also be ignored\n\nMozilla/5.0 (Macintosh; Intel Mac OS X 11_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/93.0.4619.141 Safari/537.36\nMozilla/5.0 (Macintosh; Intel Mac OS X 10_15) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/93.0.4593.122 Safari/537.36\n\n// Additional user-agents can be listed here\n```\n\n\u003e [!NOTE]\n\u003e #### 📜 How to translate (localize) this extension?\n\u003e\n\u003e ...or fix translation mistakes. The translation process described [here](src/i18n)\n\n## 👀 FAQ\n\nMost questions can be answered by reading the [issues][issues]. If the issues don't answer your question, open up a\nnew [discussion][discussions]. If you find a bug or have a feature request, please file a [new issue][new-issue].\n\n\u003cdetails markdown=1\u003e\n  \u003csummary markdown=\"span\"\u003e\n    \u003cstrong\u003eCould this extension actually be making users more uniquely fingerprintable, not less?\u003c/strong\u003e\n  \u003c/summary\u003e\n\n  Faking your user agent might make you _more_ fingerprintable, not less. There are ways other than `User-Agent`\n  sniffing to determine what browser you're using, so malicious sites could learn what browser you're _really_ using\n  through other means and then combine that with your randomly changing `User-Agent` to pretty effectively track you.\n  For background, see [this GitHub issue](https://github.com/tarampampam/random-user-agent/issues/47).\n\u003c/details\u003e\n\n\u003cdetails markdown=1\u003e\n  \u003csummary markdown=\"span\"\u003e\u003cstrong\u003eWhy do hotkeys on some sites no longer work?\u003c/strong\u003e\u003c/summary\u003e\n\n  This may occur because your User-Agent simulates MacOS - in this case, some websites attempt to handle `⌘ cmd`\n  key instead of `ctrl`. To fix this issue, simply disable the MacOS User-Agent in the extension generator settings.\n\u003c/details\u003e\n\n\u003cdetails markdown=1\u003e\n  \u003csummary markdown=\"span\"\u003e\u003cstrong\u003eAre keyboard shortcuts supported?\u003c/strong\u003e\u003c/summary\u003e\n\n  Yes, keyboard shortcuts are supported. The default shortcut for user-agent renewal is `Ctrl+Shift+U`. You can\n  change it in your browser settings: [chrome://extensions/shortcuts](chrome://extensions/shortcuts) (in Google Chrome).\n\u003c/details\u003e\n\n[issues]:https://github.com/tarampampam/random-user-agent/issues\n[new-issue]:https://github.com/tarampampam/random-user-agent/issues/new/choose\n[discussions]:https://github.com/tarampampam/random-user-agent/discussions\n\n## 🦾 Contributors\n\nI want to express my heartfelt gratitude to everyone who has contributed to this project:\n\n[![contributors](https://contrib.rocks/image?repo=tarampampam/random-user-agent)][contributors]\n\n[contributors]: https://github.com/tarampampam/random-user-agent/graphs/contributors\n\n## 🛡 Privacy Policy\n\n\u003e [!IMPORTANT]\n\u003e TL;DR: Random User-Agent has never collected and will never collect any personal data or browsing history.\n\nYou can find the full privacy policy text [here](PRIVACY_POLICY.md).\n\n\u003cdetails markdown=1\u003e\u003csummary markdown=\"span\"\u003e\u003cstrong\u003e🚀 How to publish a release\u003c/strong\u003e\u003c/summary\u003e\n\n\u003e [!NOTE]\n\u003e This note is for me, so I don't forget anything...\n\n1. Make the required changes in this repository and test them locally\n2. Publish a new release using the [releases page][releases]\n3. Open the \"[Chrome Web Store Developer Dashboard][chrome-upload-new]\", send a draft to review\n4. Download the `main.crx` file from the dashboard, rename it to `random-user-agent.crx`, and upload it to the\n[release on GitHub][releases]\n5. Open the \"[Mozilla add-on developer hub][ff-upload-new]\", download the `random_user_agent_X.X.X-blabla.xpi`\nfile from the dashboard (**after** receiving `Approved` status for the version), rename it to\n`random-user-agent.xpi`, and upload it to the [release on GitHub][releases]\n6. Don't forget to update the [Edge][edge-upload-new] and [Opera][opera-upload-new] stores\n7. Open a bottle of beer; you've earned it!\n\u003c/details\u003e\n\n[chrome-upload-new]:https://chrome.google.com/webstore/devconsole/ea9e18ff-c849-424a-acba-9b43eaad29c8/einpaelgookohagofgnnkcfjbkkgepnp/edit/package\n[ff-upload-new]:https://addons.mozilla.org/en-US/developers/addon/random_user_agent/versions/submit/\n[edge-upload-new]:https://partner.microsoft.com/en-us/dashboard/microsoftedge/6e5e9cbf-8846-4830-9fa5-9f77d03aa39f/packages\n[opera-upload-new]:https://addons.opera.com/developer/package/266286/?tab=versions\n[releases]:https://github.com/tarampampam/random-user-agent/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarampampam%2Frandom-user-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftarampampam%2Frandom-user-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarampampam%2Frandom-user-agent/lists"}