Serci is a local implementation of DuckDuckGo's bangs. It allows you to quickly search and navigate to your favorite services using ! shortcuts (e.g., !w for Wikipedia), while being faster and more privacy friendly by keeping all redirection logic inside your browser.
Supercharge your search bar.
video-example.mp4
- Local Implementation: Faster bang searches
- Bang Shortcuts: Use
!shortcuts to quickly search on your favorite platforms (e.g.,!ytfor YouTube) - Open for Contributions: Add your own services and shortcuts
Prerequisites: Node.js and pnpm
Note: there are some hard coded urls inside the homepage.js, index.js, opensearch.xml and serci.js. Those should be changed if you want to deploy this yourself.
# Clone the repository
git clone https://github.com/Shohan-Sarker/sercis
# Navigate to project directory
cd serci
# Install dependencies
pnpm install # or npm install
# Start the application
pnpm serve # pnpm install serveAdd custom bangs using bangs-array.ts. Follow this format:
{
"name": "Google",
"title": "Search the Web",
"shortcut": "g",
"link": "https://www.google.com/search?q={{{q}}}",
"category": "General Search"
}- Use
{{{q}}}as the query placeholder in URLs - Keep shortcut names concise
- Maintain consistent categorization
- Test your new service before submitting
- Update documentation if adding new categories
- Clone the repository
- Create a new branch for your changes
- Add/modify services in
bangs-array.ts - Test your changes locally
- Submit a PR with clear description of changes
- Inspired by Theo's unduck
- Built with Node.js
