logo
golauncher

A go application launcher


license



go report card


A simple, highly extensible, customizable application launcher and window switcher written in less than 300 lines of Golang and fyne


screenshot
screenshot

golauncher is a simple, highly extensible application launcher written in Golang. Its written using fyne in less than 300 lines of Go (actually, most of them are just layouts!).

Works on i3, Xfce, GNOME, Plasma, fynedesk, …

📒 Features

The basic plugin set adds the following functionalities to golauncher:

  • Window fuzzy search
  • Program fuzzy search
  • Opening URLs
  • Taking screenshot
  • Process kill
  • ….. add yours!

💻 Installation

Download the release, extract the tarball in your system and run make install.

As it does use fyne, does not depend on GTK or either QT installed on your system.

👷 Build from source

You can also build golauncher locally with go build.

Note: plugins are standalone binaries and not part of golauncher, you need to install them separately, or if you are developing, use --plugin-dir to point to a specific plugin directory.

🏃 Run

Once you have golauncher installed you can either run it from the terminal with golauncher, or either start it from the application menu.

GLOBAL OPTIONS:
   --theme value        [$THEME]
   --plugin-dir value   [$PLUGIN_DIR]

Golauncher takes optionally a theme with --theme and an additional directory to scan for plugins (--plugin-dir).

The plugin directory must contains binary prefixed with golauncher- in order to be loaded.

✏️ Extensible

golauncher is extensible from the bottom up, and indeed the core does provide no functionalities besides the GUI displaying.

⚙️ Writing extensions

Extensions can be written in any language. golauncher reads binaries starting with golauncher- prefix inside $PATH and automatically invokes them while the user is submitting inputs to retrieve results to be displayed to the user. Optionally, golauncher takes a PLUGIN_DIR environment variable (or --plugin-dir as args) to specify an additional plugin directory to use.

All the current functionalities of golauncher are split into separate plugins. Plugins can be written in any language. For examples on how to extend golauncher, see the plugin folder in this repository.

🎨 Themes

Golauncher supports custom themes, you can find examples inside the themes folder.

To run golauncher with a theme, run:

$ THEME=/home/mudler/.golauncher/monokai.yaml golauncher
or
$ golauncher --theme /home/mudler/.golauncher/monokai.yaml

sand

Screenshot from 2022-01-07 23-05-33

blue_light

Screenshot from 2022-01-07 23-06-34

blue_night

Screenshot from 2022-01-07 23-07-04

License

MIT License

Copyright (c) 2022 Ettore Di Giacinto

GitHub

View Github