Ulauncher Revived 🐧

This repo was an attempt to fix critical Ulauncher issues during a time Ulauncher development went stale.

The author of the fork has now been given shared ownership of the main Ulauncher repository and development will continue there in collaboration with the author and contributors.

This repository will continue to live for a while, until Ulauncher v6 has been released. While Ulauncher v5 has a developed a lot further than this fork, not all the features from the fork has been featured in any Ulauncher release yet. But as of Ulauncher v6 they will have.

Supported distros

Arch yay ulauncher-revived-git(installs from git dev branch)

App Search	File Browser	Custom Themes

Create your own Extensions Create your own Color themes

Using with Systemd

If your distribution packages ulauncher.service or if you download it manually, then you can enable and start ulauncher by running:

systemctl --user enable --now ulauncher.service

Known Issues

Ubuntu 14.04 is not supported since v4.0
If your DE doesn't use compositing, run ulauncher with --no-window-shadow to remove a black box around a window
[Solved] inotify watch limit reached
[Workaround exists] Can't map the keys to ALT+SPACE
[Workaround exists] Hotkey doesn't work in Wayland when is triggered from certain apps
[Workaround exists] Border appears around ulauncher window in Sway DE

Code Contribution

Project	Contributor-friendly Issues
Ulauncher App
Frontend for extensions website Uses ReactJS
API for extensions website Uses Python and bottle library

Code contributions are very welcome, but for your own sake please do create an issue first (if there aren't any) to confirm that the maintainers want your PR.

Checkout Code Contribution Guidelines for more info.

Setup Development Environment

You must have the following things installed:

Yarn
python3-setuptools

Application runtime dependencies. (You don't have to manually install these if you have 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-ayatanaappindicator3-0.1 \
  python3-dbus \
  python3-levenshtein \
  python3-pyinotify \
  python3-websocket \
  python3-xdg

Build and Run

If you have Ulauncher installed, make sure you stop the background process (systemctl --user stop ulauncher.service)
./bin/ulauncher runs the app

License

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

friday/Ulauncher-Revived