https://github.com/baltpeter/custom-search-engines

My custom search engines as OpenSearch descriptions to appease Firefox
https://github.com/baltpeter/custom-search-engines

firefox hacktoberfest opensearch-descriptions search-engines

Last synced: 4 months ago
JSON representation

My custom search engines as OpenSearch descriptions to appease Firefox

• Host: GitHub
• URL: https://github.com/baltpeter/custom-search-engines
• Owner: baltpeter
• License: cc0-1.0
• Created: 2020-06-21T18:45:26.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-05-31T20:52:59.000Z (over 4 years ago)
• Last Synced: 2025-04-02T22:46:03.755Z (6 months ago)
• Topics: firefox, hacktoberfest, opensearch-descriptions, search-engines
• Language: HTML
• Homepage: https://search-engines.bn.al/
• Size: 192 KB
• Stars: 4
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# My custom search engines – Simple list of OpenSearch descriptions

> A simple static website that exposes my custom search engines as OpenSearch descriptions, generated from a simple JSON array.

![A screenshot of the website](screenshot.png)

I like to use custom search engines. Firefox unfortunately does not have an interface to add them. In fact, they [recently even dropped](https://www.fxsitecompat.dev/en-CA/docs/2020/window-external-addsearchprovider-is-now-a-dummy-function/) the API for programmatically adding them.  

The suggested workaround is to [create an addon](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides) that adds your custom search engines. Unfortunately, one addon can only add a single search engine. That doesn't exactly scale well.

This leaves [OpenSearch descriptions](https://developer.mozilla.org/en-US/docs/Web/OpenSearch) as the only sort-of viable method. So, here are my custom search engines as OpenSearch descriptions.

This repo contains a very simple script that generates a webpage exposing my custom search engines as OpenSearch descriptions. They are generated from the [`engines.json` file](engines.json). Run the script using: `node build.js`  

A live version is available at: [search-engines.bn.al](https://search-engines.bn.al/)

My search engines probably aren't useful for you. Feel free to try them, though.

## License

This project is so simple, it likely cannot even be copyrighted. Just in case, I am releasing it under a CC0 license, though. See the [`LICENSE` file](LICENSE) for more details.  

If you have any suggestions, feel free to open an issue or submit a pull request.