ueli

This is a keystroke launcher for Windows and macOS.

Table of contents

• Installation
• Features
• Keyboard shortcuts
• Settings
• Updating
• Privacy
• Known bugs
• Development
• Alternatives
• License
• Release notes

Installation

Installer / Zip

• Download the latest version here
• Run the installer or unzip
• Run the application

Note: because the executables are not signed Windows will probably prevent you from executing the installer or the program itself. You can click "Run anyway" to install/run the program.

Installing via chocolatey repository

• Open a powershell with administration rights (Right click on your start button and click Windows PowerShell (Admin)
• Type choco install ueli
• Accept the upcoming prompt by entering y or run above command with -y switch
• Run the application

Features

Application Search

This plugin is searching for applications on your computer. You can specify the folders where your applications are installed and which file extension should be used to recognize an application.

Calculator

This Plugin lets you quickly do simple calculations.

Commandline

This plugin enables you to quickly execute commandline commands.

Color Converter

This plugin enables you to quickly convert colors into different formats.

Currency Converter

This plugin enables you to quickly convert currencies. The latest conversion rates are provided by https://exchangeratesapi.io/.

Email

This plugin enables you to quickly start writing an email by typing in an email address.

Everything (Windows only)

This feature enables you to use Everything Search to find files and folders on your local file system.

1. Install "Everything" and the "Everything Command-line interface" from https://www.voidtools.com/downloads.
2. Specify the file path to es.exe in ueli's settings.

mdfind (macOS only)

This plugin enables you to use the native macOS search to find files and folders on your local file system.

File Browser

This plugin enables you to browse through your local file system. To start you have to enter a valid absolute filepath.

Operating System Commands

Operating system commands are simple commands to control your operating system e.g. to shutdown or restart your computer.

Operating System Settings

This plugin enables you to quickly find operating system settings.

Shortcuts

This plugin enables you to quickly open files or websites by setting up your own shortcuts.

Simple Folder Search

This plugin enables you to quickly search for files or folders.

Translation

This plugin enables you to quickly translate words or short sentences. It uses an unofficial API for Linguee and may be unstable.

UWP (Windows only)

This plugin enables you to find preinstalled UWP apps.

URL

This plugin enables you to quickly open websites by typing in a URL.

Web Search

This plugin enables you to quickly search the internet with your favorite web search engine by setting up your own web search engines.

Workflow

This plugin enables you to quickly execute multiple things at once.

Keyboard shortcuts

Keyboard shortcut	Description
Enter	Execute selected search result
Shift Enter	Execute selected program as admin (Windows only)
Tab	Autocomplete file path
Ctrl o	Open the selected program or file at it's location (Windows)
Cmd o	Open the selected program or file at it's location (macOS)
↑	Scroll up
↓	Scroll down
Ctrl i	Open settings (Windows)
Cmd ,	Open settings (macOS)
Shift ↑	Browse user input history up
Shift ↓	Browse user input history down
Ctrl l	Set focus on user input

Settings

To open the settings simply search for "Settings" or press Ctrl+i on Windows or Cmd+, on macOS. Here you can start configuring the app to your needs by enabling/disabling features or changing the settings.

Updating

The check if any updates are available open the settings. Under "General Settings" you can check if an update is available or not.

On Windows you can directly update the app. On macOS you have to manually download the newest release and replace the existing app.

Privacy

For better search results ueli is keeping track of the applications, files and folders you are executing. If you don't want ueli to track your executions simply open the settings and click on the "three-dot" menu on the top right and choose "Clear execution log" and disable the option "Log execution".

Known bugs

• (#37) Window starts to move while typing when custom scaling in Windows is set.
• (#92) If you see an error that says spawn powershell.exe ENOENT check if powershell is installed (should be installed in all recent Versions of Windows by default) and check if powershell is in the PATH variable.

For more check here.

Development

Requirements

• Git
• Node 12.x.x
• Yarn

Setup

$ git clone https://github.com/oliverschwendener/ueli
$ cd ueli
$ yarn

Run

$ yarn bundle
$ yarn start

Note: there is also a watch task $ yarn bundle:watch which watches the typescript files and bundles them automatically if there are any changes.

Debug

For debugging Visual Studio Code is recommended.

1. Go to .vscode folder
2. Make a copy of launch.example.json and rename it to launch.json
3. Select one of the preconfigured debug modes and start debugging

Run tests

$ yarn test

Package

Create portable version

$ yarn package:dir

Create installer

$ yarn package

Alternatives

• khanhas/ueli
• Launchy
• Wox
• Keypirinha
• Alfred
• Hain
• Zazu App
• Cerebro

License

Copyright (c) Oliver Schwendener. All rights reserved. Licensed under the MIT License.