Installation

Arch Linux

Install sgtk-menu from AUR.

PKGBUILD for the development version:

# Maintainer: Piotr Miller <nwg.piotr@gmail.com>

pkgname=sgtk-menu-git
pkgver=0.8.0.r2.ge96733a
pkgrel=1
pkgdesc="GTK menu for sway, i3 and some floating WMs (development version)"
arch=('x86_64')
url="https://github.com/nwg-piotr/sgtk-menu"
license=('GPL3')
conflicts=('sgtk-menu')
provides=('sgtk-menu')
depends=('gtk3' 'python' 'python-gobject' 'python-cairo' 'python-setuptools')
optdepends=('python-pynput: for positioning in floating window managers')

source=("git+https://github.com/nwg-piotr/sgtk-menu.git")
md5sums=('SKIP')

pkgver() {
  cd sgtk-menu
  git describe --long --tags | sed 's/^v//;s/\([^-]*-g\)/r\1/;s/-/./g'
}

package() {
  cd sgtk-menu
  /usr/bin/python setup.py install --root="$pkgdir/" --optimize=1
}

Fedora

sudo dnf install sgtk-menu

Other distributions

1. Make sure you have installed all the dependencies:

   • gtk3
   • python (python3) >= 3.4
   • python-gobject
   • python-cairo | python-cairocffi
   • python-setuptools
   • python-pynfo: optionally for use in floating WMs

2. download and unpack a tarball from the latest release;

3. change (cd) to the new directory, and then, on the command line, enter:

python3 setup.py install --user

For the development version, just clone the repository, instead of using the release tarball.

Launching

Sample sway key binding:

bindsym mod1+F1 exec sgtk-menu -f -a

Sample i3 key binding:

bindsym Mod1+F1 exec --no-startup-id sgtk-menu -f -af appendix-i3

For proper positioning in i3, it's recommended to add the following line to the config file:

for_window [title="~sgtk-"] border none, floating enable

As a replacement to Openbox menu

You need to edit the mouse right click binding, e.g. like this:

<mousebind action="Press" button="Right">
  <action name="Execute">
    <command>sgtk-menu -f -af appendix-ob</command>
  </action>
</mousebind>

See Commands for more options.