Qubes-Community-Content/docs/configuration/qmenu.md
SINE3o14NNAE 8296f21393
Update qmenu.md
Customization for latest qmenu has changed.
2019-12-16 21:45:21 +00:00

3.1 KiB

qmenu - Manage Qubes via dmenu

qmenu is a collection of tools that utilize dmenu, a dynamic menu for X, to provide you with a drop down menu for Qubes specific tasks.

When configured to execute these tools via hotkeys, you are able to list, start and stop your qubes, attach and detach your connected devices, adjust your qube preferences, firewall rules, per-qube keyboard layouts, launch applications and more, very quickly with only the keyboard.

List of qmenu tools:

  • qmenu-al - Launch domU applications.

  • qmenu-dm - List and manage your connected devices.

  • qmenu-vm - List, manage and configure your qubes.

Warning

qmenu is not included in the Qubes dom0 repositories. This page will show you how to install qmenu by cloning its repository to a disposable qube and copying its contents to dom0. However, this way of installing software in dom0 is not advised and can compromise the security of your system!

Furthermore, qmenu is unreviewed third party software and is in no way endorsed by the Qubes team. You have to trust its maintainers to not act maliciously and to protect it from malicious and unsafe contributions. Keep in mind that you are installing these tools in dom0, so judge accordingly.

Installation

  • Install dmenu:

     [user@dom0]$ sudo qubes-dom0-update dmenu
    
  • Start a disposable qube that is able to connect to the internet. Do not use this qube for anything else! Then inside this qube; clone the qmenu repository with git:

     [user@dispXXXX ~]$ git clone https://github.com/sine3o14nnae/qmenu/
    
  • Import the authors public key:

     [user@dispXXXX ~]$ gpg2 --keyserver pool.sks-keyservers.net --recv-keys 0xCBE6 0BC2 811F FE14 333F EE05 3435 0BCA 3DDE 9AD9
    
  • Check the validity of the signed commit:

     [user@dispXXXX ~/qmenu/]$ git show --show-signature
    
  • Finally, decide what qmenu tools you want to use, replace 'XX' accordingly, then copy them to dom0, place them inside your path and change their mode bits.

     [user@dom0 ~]$ qvm-run --pass-io dispXXXX 'cat /home/user/qmenu/qmenu-XX' > /tmp/qmenu-XX
    
     [user@dom0 ~]$ sudo cp /tmp/qmenu-XX /usr/bin/
    
     [user@dom0 ~]$ sudo chmod 755 /usr/bin/qmenu-XX
    

Customization

qmenu

The colors that correspond to a qube label can be adjusted by appending --{LABEL}=#{HEX VALUE} for any qube label, when executing a qmenu tool.

Try the following example for visually appealing colors:

 --purple=#a020f0 --blue=#4363d8 --gray=#bebebe --green=#3cb44b --yellow=#ffe119 --orange=#f58231 --red=#e6194b --black=#414141

dmenu

In order to customize and configure dmenu, instead of downloading it from the repositories, you have to get it from suckless, compile it yourself and copy it to dom0. However, this way of installing software in dom0 is not advised and can compromise the security of your system!