MichaelAquilina / Ulauncher

Fast application launcher for Linux

Master: Dev:

Application Launcher for Linux 🐧

Ulauncher s a fast application launcher for Linux written in Python and uses GTK+ as a GUI toolkit.

App Search	File Browser	Custom Themes

Create Your Ulauncher Extensions

Since Ulauncher v3 you can create your own Ulauncher extensions
Check out docs.ulauncher.io to find out how.

Create Your Ulauncher Color themes

Since Ulauncher v4 you can create your own color Themes
Check out docs.ulauncher.io to find out how.

Known Issues

• Ubuntu 14.04 is not supported since v4.0
• inotify watch limit reached
• Hotkey doesn't work in Wayland when is triggered from certain apps

Install for Development

If you just want to use the app see download instructions at ulauncher.io

Dev Requirements

• Docker

• python-distutils-extra

• Application runtime dependencies.
  (You don't have to manually install those if you had already installed Ulauncher)

  sudo apt-get install \
    libkeybinder-3.0-0 \
    libgtk-3-0 \
    gir1.2-gtk-3.0 \
    gir1.2-keybinder-3.0 \
    gir1.2-webkit2-4.0 \
    gir1.2-glib-2.0 \
    gir1.2-notify-0.7 \
    gir1.2-gdkpixbuf-2.0 \
    gir1.2-appindicator3-0.1 \
    python-dbus \
    python-levenshtein \
    python-pyinotify \
    python-pysqlite2 \
    python-websocket \
    python-xdg \
    python-distutils-extra
  

Build and Run

1. $ ./build-utils/dev-container.sh will take you into a Docker container from which you can run build and test scripts
2. root@container: # ./build-utils/build-preferences.sh build preferences UI in JS/HTML
3. root@container: # ./test tests runs Python tests
4. $ ./dev-run.sh installs Ulauncher data to ~/.local/share/ulauncher/ and then runs the app

If you have any questions, join chat in Gitter

---

Want to contribute? See How!

---

License

See the LICENSE file for license rights and limitations (GNU GPL v3.0).