pub / serci

Search the web with !keywords
git clone
Log | Files | Exports | Refs | README | RSS

Activity: Jul, 2024 - Jul, 2024

Less More


Search the web with !keywords.

Please send patches or remarks to jayvii+serci[AT]posteo[DOT]de.


What does serĉi mean?

It is the Esperanto term for “to search”.

What are !keywords?

An idea lent from the search Engine DuckDuckGo, which has been utilized by many others since. They call their keywords bangs, but it is the same concept and usability:

bangs are shortcuts that quickly take you to search results on other sites. For example, when you know you want to search on another site like Wikipedia or Amazon, our bangs get you there fastest. A search for !w filter bubble will take you directly to Wikipedia.

Remember, though, because your search is actually taking place on that other site, you are subject to that site’s policies, including its data collection practices.

We’ve had bangs since 2008 as part of our geek roots. Now we have thousands of !bangs and you can even submit your own.

serĉi implements keywords for all kinds of search engine and transparently redirects you right to them. The default set of search engine and fall-backs is geared towards privacy and data minimalism. However, you can simply host serĉi yourself any time and configure your own favorite search engines and !keywords.

If you think there are !keywords that other people would benefit from, feel free to contribute!

How can I use serĉi?


Simply upload the entire content of this repository to your webhost. Edit opensearch.xml accordingly. If the domain you want to run serĉi under is, you can simply run:

Search-Engines and !keywords are configured in config/config.php. For fast access to !keywords and categories, seriĉi uses mappings written to json files. Before first run, you need to generate them from your config via lib/generate_mappings.php. This needs to be re-run everytime you adjust your config/config.php.


Example-configuration for Apache2:


serĉi is under the AGPL-3.0 license. It is REUSE compliant!

Icons are licensed under CC-BY-SA-4.0.

Other bundled assets are:

Clone this repository via:
git clone