Skip to content

firefox extension for user agent spoofing with always up-to-date user agents and some nice features

License

Notifications You must be signed in to change notification settings

ShrekBytes/unga-bunga-User-Agent

Repository files navigation

Unga Bunga User-Agent

A Firefox extension for user agent spoofing with always up-to-date user agents and some nice features

Extension Badge License Firefox

πŸ“‹ Table of Contents

✨ Features

🎯 Core Functionality

  • Preference: Can select devices, browsers - (all, one, multi category)
  • Multiple Modes: All sites, Whitelist, or Blacklist operation
  • Custom User Agents: Add your own user agent strings and can add to lists
  • Smart Random: Intelligent user agent selection based on preferences
  • Auto-Random: Automatic user agent rotation at set intervals from the selected preferences

🎨 Modern Interface

  • Clean, Minimal Design: Modern dark theme with intuitive controls
  • Responsive Layout: Optimized for all screen sizes(desktop, mobile)
  • Visual Feedback: Toast notifications and status indicators

πŸ“¦ Installation

From Firefox Add-ons Store (Recommended)

  1. Visit the Firefox Add-ons store
  2. Search for "Unga Bunga User-Agent"
  3. Click "Add to Firefox"
  4. Confirm the installation

Manual Installation (Developer)

  1. Download the extension files
  2. Open Firefox and go to about:debugging
  3. Click "This Firefox" β†’ "Load Temporary Add-on"
  4. Select the manifest.json file

πŸš€ Quick Start

  1. Enable the Extension

    • Click the extension icon in your toolbar
    • Toggle the "Enabled" switch to ON
  2. Choose a User Agent

    • Select from the filtered list
    • Or use "Random UA" for automatic selection
    • Or use "Smart Random" for intelligent selection
  3. Apply Changes

    • Your user agent is now active
    • Check the badge color for status confirmation

Quick Start

πŸ“– Usage Guide

Basic Controls

Current User Agent Section

  • Text Area: View and edit the current user agent string
  • Apply Button: Apply the edited user agent
  • Random UA: Select a random user agent from all available
  • Reset Default: Return to your browser's default user agent

Basic Controls

Preferences Section

You can choose multiple, all, one, as per your need

  • Device Filter: Choose Android, iPhone, iPad, Linux, Mac, or Windows
  • Browser Filter: Select Chrome, Firefox, Edge, Opera, Safari, or Vivaldi
  • Source Filter: Choose from All, Custom, Latest, or Most Common user agents
  • Smart Random: Intelligent selection based on your preferences

Preferences

Auto Smart Random

  • Toggle: Enable/disable automatic user agent rotation
  • Interval: Set rotation time (1-60 minutes)
  • Smart Selection: Uses your device and browser preferences

Auto Random

Custom User Agents

  • Add Custom: Enter your own user agent strings
  • Remove: Delete custom user agents with the Γ— button
  • Persistent: Custom agents are saved between sessions

Custom User Agents

πŸ”§ Advanced Features

Site-Specific Control

Click "Advanced Options" to access site-specific settings:

Modes

All Sites Mode (Default)

  • User agent applied to all websites
  • No site list management needed
  • Perfect for general privacy

Whitelist Mode

  • User agent applied ONLY to specified sites
  • Add sites to the whitelist
  • All other sites use your real user agent

Blacklist Mode

  • User agent applied to all sites EXCEPT specified ones
  • Add sites to the blacklist
  • Excluded sites use your real user agent

Site Management

  • Add Sites: Click "Add Site" and enter domain (e.g., example.com)
  • Remove Sites: Hover over a site and click the Γ— button
  • Real-time Updates: Changes apply immediately

Site Management

🎨 Badge Indicators

The extension icon shows your current status:

Badge Color Status Description
πŸ”΄ OFF Red Disabled Extension is turned off
🟒 ALL Green All Sites Working on all websites
πŸ”΅ WL Blue Whitelist Working only on whitelisted sites
🟣 BL Purple Blacklist Working on all sites except blacklisted

Badge Examples

πŸ”„ Update User Agents

  • Automatic: User agents are cached for 24 hours
  • Manual Update: Click "Update User Agents" to refresh the list
  • Latest Sources: Always get the most recent user agent strings

Update

πŸ› οΈ Troubleshooting

Common Issues

Badge not showing?

  • Reload the extension
  • Check if the extension is enabled

User agent not changing?

  • Ensure the extension is enabled
  • Check if the site is in blacklist/whitelist
  • Try refreshing the page

Advanced options not visible?

  • Click "Show" next to "Advanced Options"
  • The section is collapsed by default

🀝 Contributing

Found a bug or have a feature request? Open an issue or submit a pull request.

πŸ™ Acknowledgments

πŸ“„ License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

About

firefox extension for user agent spoofing with always up-to-date user agents and some nice features

Topics

Resources

License

Stars

Watchers

Forks