https://github.com/shenoy-anurag/firefox-add-custom-search-engines
A Firefox WebExtension to allow the user to add any Search Engine to their browser. Get back full control over search.
https://github.com/shenoy-anurag/firefox-add-custom-search-engines
firefox-addon firefox-extension manifest-v2 search webextension
Last synced: 5 months ago
JSON representation
A Firefox WebExtension to allow the user to add any Search Engine to their browser. Get back full control over search.
- Host: GitHub
- URL: https://github.com/shenoy-anurag/firefox-add-custom-search-engines
- Owner: shenoy-anurag
- License: mit
- Created: 2025-04-19T21:34:04.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-28T07:16:56.000Z (5 months ago)
- Last Synced: 2025-04-28T08:22:55.869Z (5 months ago)
- Topics: firefox-addon, firefox-extension, manifest-v2, search, webextension
- Language: JavaScript
- Homepage: https://addons.mozilla.org/en-US/firefox/addon/add-custom-search-engines/
- Size: 524 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Custom Search Engines Firefox Extension
This Firefox extension allows users to add custom search engines to Firefox's search functionality. Get back full control over search.
**Install from the Firefox Addons Marketplace**
https://addons.mozilla.org/en-US/firefox/addon/add-custom-search-engines/
Please rate my addon after checking it out.
## Quick Look
#### Search Preview
#### Settings Screen
## Features
- Add custom search engines with their search URL
- Support for both GET and POST search methods
- Custom icons for each search engine
- Quick access from the toolbar popup
- Omnibox integration using the "@" keyword
- Manage search engines through a settings page## Installation
**Install from the Firefox Addons Marketplace**
https://addons.mozilla.org/en-US/firefox/addon/add-custom-search-engines/## Manual Installation
1. Download the extension files
2. Open Firefox and go to `about:debugging#/runtime/this-firefox`
3. Click "Load Temporary Add-on..."
4. Select any file from the extension folder## Usage
### Adding a Search Engine
1. Click the extension icon in the toolbar
2. Click "Settings" in the popup
3. Click "Add New Engine"
4. Fill in the form:
- **Name**: Display name for the search engine
- **Search URL**: The URL with `{searchTerms}` where the query should be inserted
- **Icon URL**: URL to the icon image (favicon, PNG, or SVG)
- **HTTP Method**: GET (default) or POST
- **Short Name**: Optional short name for omnibox access### Using a Search Engine
#### From the Popup:
1. Click the extension icon in the toolbar
2. Enter your search terms
3. Click on the search engine button#### From the Address Bar (Omnibox):
1. Type "@" followed by the search engine's short name and your search terms
2. Example: `@gpt how to create a Firefox extension`## File Structure
- `manifest.json`: Extension configuration
- `background.js`: Background script for main functionality
- `popup.html` & `popup.js`: Toolbar popup UI
- `options.html` & `options.js`: Settings page UI
- `search.html` & `search.js`: Helper page for POST requests
- `icons/`: Extension icons## Customization
You can modify the UI styling by editing the CSS in the HTML files. The extension uses browser storage to save search engines, so your data persists between browser sessions.
## License
This project is open sourced, under the MIT License. Feel free to modify and distribute as needed.