https://github.com/cizzuk/cse
Customize your Safari's Search Engine
https://github.com/cizzuk/cse
ios ipados macos safari-extension visionos
Last synced: 27 days ago
JSON representation
Customize your Safari's Search Engine
- Host: GitHub
- URL: https://github.com/cizzuk/cse
- Owner: Cizzuk
- License: mit
- Created: 2022-12-29T10:14:01.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-02-03T13:56:48.000Z (about 1 month ago)
- Last Synced: 2026-02-04T04:07:41.475Z (about 1 month ago)
- Topics: ios, ipados, macos, safari-extension, visionos
- Language: Swift
- Homepage: https://cizzuk.net/projects/cse/
- Size: 19.3 MB
- Stars: 131
- Watchers: 5
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Support: Supports/AppInitializer.swift
Awesome Lists containing this project
README
# Customize Search Engine
Safari Extension to customize your search engine.
**[Download on the App Store](https://apps.apple.com/app/customize-search-engine/id6445840140)**
**[AltStore PAL Source](https://i.cizzuk.net/altstore/)**
## Features
### Customize your Search Engine
Change Safari's default search engine.
This is the most basic feature.
### CSE for Private Browse
Switch search engines in Private Browse.
### Quick Search
Enter the keyword at the top to switch search engines.
Example:
- Search [`br something`](https://search.brave.com/search?q=something) to search in Brave Search
- Search [`wiki Safari`](https://en.wikipedia.org/w/index.php?title=Special:Search&search=Safari) to find Safari on Wikipedia
- Search [`yt Me at the zoo`](https://www.youtube.com/results?search_query=Me+at+the+zoo) to find the oldest videos on YouTube
- Search [`wbm example.com`](https://web.archive.org/web/*/example.com) to see past versions of the website
### Emoji Search
If you enter only one emoji, you can search on [Emojipedia.org](https://emojipedia.org).
### Switch Search Engines by Shortcuts and Focus
You can use a different custom search engine or disable CSE while at work, school, etc.
## How it works
CSE works on pages from Safari's default search engines (Google, DuckDuckGo, etc.).
It detects the special parameters in the URL when searching from Safari's search bar. (For example, Google has the parameter `client=safari` in its URL.)
Then automatically redirects the page to your search engine.
### If the custom search engine has POST Data
CSE needs to create `` on the page to submit the form.
To avoid [CSP restrictions](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP), CSE generates the local page (called `post_redirector.html`) and redirects to it first. Then the page creates the form and submits it.
> [!NOTE]
> This feature may not work on macOS and iOS 16.x due to Safari bugs.
## License
This application is licensed under the [MIT License](https://github.com/Cizzuk/CSE/blob/main/LICENSE).