Skip to content
Kelvin Wu edited this page Dec 13, 2024 · 8 revisions

Installation

See README

First steps

  • When you launch the app for the first time the main window will show up and you can start typing for what you're looking for.
  • Use the hotkey "Alt+Space" to show/hide Ueli.
  • Use the arrow keys to navigate up and down in the search result list.
  • Press "Enter" to launch the selected item.
  • Press "Cmd+K" (macOS) or "Ctrl+K" (Windows, Linux) to open the additional actions of the selected search result item and use the arrow keys to navigate up and down in the menu. Press "Enter" to invoke the selected action. Press "Escape" to close the additonal action menu.
  • To add a frequently used item to your favorites open the additional actions menu and click on "Add to Favorites". Now this item will appear always first in the search result list. To remove an item from your favorites open the additional actions and click on "Remove from favorites". Alternatively, you can also open the settings and go to "Favorites" to see all favorites. Click on the "x" icon to remove an item from your favorites.
  • Press "Cmd+," (macOS) or "Ctrl+," (Windows, Linux) or click on the "Settings" button to open the settings. Here you can configure Ueli to your liking.
  • To browse the extensions click on "Extensions" in the left navigation. Toggle the switch to enable/disable an extension. As soon as an extension is enabled an additional item will appear in the left navigation where you will find the settings for that specific extension. You'll find more info about the extensions here.

Debugging

If something does not work as expected, go to "Settings" and click on "Debug".

Here you might find some logs that help find the issue.

image

Settings

⚠️ Under construction...

Known issues

Linux

Global hotkeys may not work under Wayland sessions. As a workaround, bind a custom shortcut in your system settings to call ueli to show and focus the main window, or ueli --toggle to toggle the main window.

Clone this wiki locally