Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/moijesuis2enmoi/chrome-referer-spoofer

Referer Spoofer is a Chrome extension that allows users to set a custom Referer header for their HTTP requests
https://github.com/moijesuis2enmoi/chrome-referer-spoofer

chome chrome-extension chrome-extensions referer referer-remover referer-spoof referer-spoofer spoofing

Last synced: about 1 month ago
JSON representation

Referer Spoofer is a Chrome extension that allows users to set a custom Referer header for their HTTP requests

Awesome Lists containing this project

README

        

# Referer Spoofer - Chrome Extension

**Referer Spoofer** is a Chrome extension that allows users to set a custom Referer header for their HTTP requests. This tool is particularly useful for developers who need to test referer-based functionalities or simulate traffic sources in web applications.

![Referer Spoofer Extension Screenshot](./image/image-presentation.png)

## Features

- **Easy Customization**: Set a custom Referer header through a user-friendly interface.
- **Instant Page Refresh**: Automatically refreshes the page after applying the new referer.
- **Developer-Friendly**: Ideal for testing behaviors related to referer-based traffic and redirections.
- **Quick Access Links**: Includes useful links to documentation and resources for easy reference.

## Installation

1. Clone this repository:

```bash
git clone https://github.com/yourusername/referer-spoofer-extension.git
```
2. Open Chrome and navigate to `chrome://extensions/`.
3. Enable **Developer mode** by toggling the switch in the upper right corner.
4. Click on **Load unpacked** and select the `src` folder from the cloned repository.
5. The extension should now appear in your toolbar.

## Usage

1. Click on the **Referer Spoofer** icon in the Chrome toolbar.
2. Enter the URL you want to set as the custom referer.
3. Click on **Set and Refresh** to apply the referer and refresh the page.

## Permissions Justification

This extension requires the following permissions to function properly:

- **declarativeNetRequest**: To modify outgoing HTTP request headers, allowing the custom referer to be set.
- **activeTab**: To interact with the current active tab where the user has enabled the extension.
- **storage**: To save the custom referer temporarily for reuse.
- **scripting**: To inject a script that refreshes the page after applying the new referer.
- **Host Access Permission**: To modify request headers on specified domains chosen by the user.

Each of these permissions is essential for providing the extension's core functionality and is used strictly in line with its purpose.

## Development

If you'd like to contribute or modify this extension:

1. Fork this repository.
2. Make your changes in a new branch.
3. Submit a pull request for review.

Please ensure your code follows the repository's coding guidelines and includes comments where necessary.

## Contributing

Contributions are welcome! If you have ideas or suggestions to improve this extension, feel free to open an issue or submit a pull request.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Contact

For any questions or support, please reach out on [GitHub](https://github.com/moijesuis2enmoi).

---

This extension was created to simplify the process of customizing HTTP referer headers for developers. Use responsibly and in compliance with each website’s terms of service.