Repository files navigation

Website ·Get Started

A general purpose application launcher for X and wayland inspired
by rofi/wofi and alfred,
build withicedandpop-launcher.

Onagre is build on top ofpop-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 ownusing 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 withpop-launcher plugins.

Dependencies:

• ⚠️pop-launcher > 1.2.4Rust 1.8 introduced a breaking change in the way sorting is handled, onagre will unexpectedly crash with older version of pop launcher.Currently, for arch users, the only way to get the latest version of pop-launcher is to build it from source.
• Qalculate (optional)

If there is no distro package available for Onagre in your preferred manager,you need Rust andcargo to build it.

From source:

git clone https://github.com/oknozor/onagre.gitcd onagrecargo build --release --lockedsudo 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:

2. Plugins:

To use a plugin simply match its regex when typing your query.

For instance thefile plugin will match^(/|~).*, typing~/ 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.

Default plugins:

Onagre will look for a theme file in$XDG_CONFIG_DIR/onagre/theme.scss and will fallback to the default theme if noneis found or if your theme contains syntax errors. To ensure your theme is correctly formatted runonagre from the terminal.

For a detailed guide refer towiki -> theming, or take a look at thetheme examples directory.

Default theme

Murz (credit tomurz)

Nord

Not-Adwaita

Solarized

Darcula

Hollow

• pop-launcher
• pop-shell
• cosmic-launcher

This project is bound by acode of conduct based on thecontributor covenant if you are not familiar with it, and want to contribute please, read it before going further.

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 youplease 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 theLICENSE file.

Credit to@themou3ad for the logo!