Skip to content

Shohan-Sarker/serci

Repository files navigation

Serci

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.


Previews

video-example.mp4

Opensearch.xml support

opensearch

Table of Contents


Features

  • Local Implementation: Faster bang searches
  • Bang Shortcuts: Use ! shortcuts to quickly search on your favorite platforms (e.g., !yt for YouTube)
  • Open for Contributions: Add your own services and shortcuts

Installation

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 serve

Contribution

Adding New Services

Add 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"
}

Key requirements:

  • 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

Pull requests are welcome! Please follow these steps:

  1. Clone the repository
  2. Create a new branch for your changes
  3. Add/modify services in bangs-array.ts
  4. Test your changes locally
  5. Submit a PR with clear description of changes

License

MIT License


Acknowledgements

About

A locally hostable "search proxy" for using !bang shortcuts. Similar to duckduckgo's.

Resources

License

Stars

0 stars

Watchers

1 watching

Forks

Contributors