Onagre is build on top of pop-launcher which makes it very versatile. The pop-launcher plugin system allow you to extend Onagre with plugins from the community or even write your own using any programming language.
- Works on x11 and wayland.
- Fully customizable theme.
- Default plugins: calc, files, pop_shell, recent, terminal, desktop entries, find, pulse, scripts, web.
- Can be extended with pop-launcher plugins.
If there is no distro package available for Onagre in your preferred manager, you need Rust and cargo to build it.
git clone https://github.com/oknozor/onagre.git
cargo build --release --locked
sudo mv target/release/onagre /usr/bin/onagre
Latest release with cargo:
cargo install --git https://github.com/onagre-launcher/onagre --tag 1.0.0
Latest upstream with cargo:
cargo install --git https://github.com/onagre-launcher/onagre
1. Key bindings:
|Autocomplete (in files mode)
|Quit without launching
To use a plugin simply match its regex when typing your query.
For instance the
file plugin will match
~/ would enable the plugin and start the file navigation.
Plugin with no prefix are enabled by default, there entry will be mixed in the search results.
|Display the most used desktop entries on start
|Search for desktop entries
|Control PulseAudio devices and volume
|Shell scripts as launcher options
|Terminal or background commands
|'ddg ', 'g', ...
|Find files using fd/find
|Recently-opened document search
|Calculator with unit conversion (uses Qalculate! expressions)
|List available pop-launcher modes
Onagre will look for a theme file in
$XDG_CONFIG_DIR/onagre/theme.scss and will fallback to the default theme if none
is found or if your theme contains syntax errors. To ensure your theme is correctly formatted run
onagre from the terminal.
Code of conduct
Having a question or suggestion for a new feature ? Feel free to open an issue or submit a PR. Currently, what we need the most is feedback from users using different window managers and hardware. If Onagre does not work out of the box for you please let us know, so we can fix it.
All the code in this repository is released under the MIT License, for more information take a look at the LICENSE file.
Credit to @themou3ad for the logo!