47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# bunbun
|
|
|
|
_Self-hostable, easy-to-configure, fast search/jump multiplexer service._
|
|
|
|
bunbun is a pure-[Rust][rust-lang] implementation of [bunny1][bunny1], providing
|
|
a customizable search engine and quick-jump tool in one.
|
|
|
|
After adding it to your web-browser and setting it as your default search
|
|
engine, you'll gain the ability to quick-jump to a specific page or search from
|
|
a specific engine:
|
|
|
|
```
|
|
g hello world // Searches "hello world" in google
|
|
r anime // Goes to reddit.com/r/anime
|
|
ls // Lists all available commands and aliases
|
|
foo bar // If foo is a defined command, do something with bar
|
|
// Alternatively, if a default route is set, use the entire
|
|
// query for the default route
|
|
```
|
|
|
|
## Installation
|
|
|
|
If you have `cargo`, you can simply run `cargo install bunbun`.
|
|
|
|
Once installed, simply run it. A default config file will be created if one does
|
|
not exist. You should model your own custom routes after the provided ones.
|
|
|
|
### Configuration
|
|
|
|
If configuring for development, no further configuration is required. If running
|
|
this for production, you should edit the `public_address` field.
|
|
|
|
### Adding bunbun as a search engine
|
|
|
|
bunbun supports the [OpenSearch Description Format][osdf].
|
|
|
|
For Chrome, simply visiting the index page will auto add bunbun as a search
|
|
engine. You simply need to set it as a default in your preferences.
|
|
|
|
For Firefox, you need to explicitly add bunbun as a search engine. This can be
|
|
done by clicking the three dots next to the star button on the url box, and
|
|
clicking on "Add Search Engine". Then, you can set it as your default search
|
|
engine.
|
|
|
|
[rust-lang]: https://www.rust-lang.org/
|
|
[bunny1]: http://www.bunny1.org/
|
|
[osdf]: https://developer.mozilla.org/en-US/docs/Web/OpenSearch
|