py-rofi-bus 0.2.0

CLI Interaction

py-rofi-bus exposes a very simple CLI to manage MainDbusDaemon.

$ which py-rofi-bus
~/.local/bin/py-rofi-bus
$ py-rofi-bus daemon -h
usage: py-rofi-bus daemon [-h] {start,status,stop} ...

positional arguments:
  {start,status,stop}  Available actions
    start              Start the daemon
    status             Check the status of the daemon
    stop               Stop the daemon

optional arguments:
  -h, --help           show this help message and exit

The CLI is independent of the daemon so it can be used to restart the daemon.

DBus Interface

systemd Integration

MainDbusDaemon can easily be run as a user systemd unit. First a target that binds to the graphical-session.target must be made.

$ cat $XDG_CONF_HOME/systemd/user/my-first.target
[Unit]
Description=Lives and dies with the graphical session
BindsTo=graphical-session.target

We can now bind a unit to the target, meaning it will also be dependent on the graphical-session. Note that the paths below assume a --user install. You’ll need to update them if py-rofi-bus was installed somewhere else.

$ cat $XDG_CONF_HOME/systemd/user/pyrofibus.service
[Unit]
Description=py-rofi-bus
PartOf=graphical-session.target

[Service]
Type=forking
ExecStart=%h/.local/bin/py-rofi-bus daemon start
ExecStop=%h/.local/bin/py-rofi-bus daemon stop
PIDFile=%h/.config/wotw/py-rofi-bus/.pid

[Install]
WantedBy=my-first.target

# Start the service to make sure it works
$ systemctl --user start pyrofibus.service

# Assuming it does, you can enable it to run automatically
$ systemctl --user enable pyrofibus.service

Finally, to trigger my-first.target, add these commands somewhere in your startup files. I run i3 and these are executed at the end of my i3 config file. The tail end of your .whateverrc file would work well too.

# Some of these might not be necessary. I never weeded out the duds.
# You'll need some of these variables to be able to trigger the target.
systemctl --user import-environment USER HOME PATH DISPLAY XAUTHORITY
systemctl --user start my-first.target

Initial Setup

Assuming you’ve installed py-rofi-bus, you’ll need to create the configuration directory.

$ mkdir -p "$XDG_CONFIG_HOME/wotw/py-rofi-bus/{apps-enabled,pids}"

To run the daemons, they must be in the load_from config directory, which is probably the one above unless you changed things.

$ cd path/to/repo/or/package
$ ls -l examples/rofi-alt-tab
total 16
-rw-r--r--. 1 cjharries cjharries 2457 Jun  3 13:06 active_window_monitor_daemon.py
-rw-r--r--. 1 cjharries cjharries 2231 Jun  3 13:06 dbus_window_daemon.py
-rw-r--r--. 1 cjharries cjharries 4826 Jun  3 13:06 ordered_window_script.py
$ chmod u+x examples/rofi-alt-tab/*.py
$ source <(
    realpath examples/rofi-alt-tab/*daemon.py | \
        awk '{ print "ln -s "$0" $XDG_CONFIG_HOME/wotw/py-rofi-bus/apps-enabled"; }' \
    )
$ ls -l ~/.config/wotw/py-rofi-bus/apps-enabled
total 12
lrwxrwxrwx. 1 cjharries cjharries 103 Jun  3 18:00 active_window_monitor_daemon.py -> <snip>/examples/rofi-alt-tab/active_window_monitor_daemon.py
lrwxrwxrwx. 1 cjharries cjharries  93 Jun  3 18:00 dbus_window_daemon.py -> <snip>/examples/rofi-alt-tab/dbus_window_daemon.py

If you’re not comfortable symlinking the files or don’t feel like going to the trouble, you can always do a vanilla copy.

You’ll also need to expose the script in some way. A generally recommended idea is to store scripts in a common location.

$ mkdir -p $XDG_CONFIG_HOME/rofi/scripts
$ cd path/to/repo/or/package
$ ln -s $(realpath examples/rofi-alt-tab/ordered_window_script.py) $XDG_CONFIG_HOME/rofi/scripts

Launching the Main Daemon

Run the following command.

$ py-rofi-bus daemon start

Launching the Example

Once the files are in the load_from directory and the daemon is running, you’ll have to either add another file or pop open a REPL.

$ python

>>> import pydbus
>>> bus = pydbus.SessionBus()
>>> loader = bus.get('pro.wizardsoftheweb.pyrofibus.daemon.window_properties')
>>> loader.load_apps()
>>> exit()

Running the Modi

With the script accessible and the daemons running, you can either execute it as a one-off or add it to your configuration.

# Runs it as a one-off
$ rofi -modi alttab:~/.config/rofi/scripts/ordered_window_script.py -show alttab

# Adds it to the existing config
$ export ROFI_CONFIG_FILE=$(rofi --help | awk 'BEGIN{ IGNORECASE = 1 };/configuration file/{ print $3; }')
$ [ -f $ROFI_CONFIG_FILE ] || rofi -dump-config > $ROFI_CONFIG_FILE
$ sed        \
    -i=.bak  \
    -e 's@\([^-]modi:.*\)";@\1,alttab:~/.config/rofi/scripts/ordered_window_script.py";@g' \
    $ROFI_CONFIG_FILE
$ rofi -show alttab

Conclusion

Like its predecessor, this example (and the package it’s from) is still very much in its infancy. Expect things to change. This is too much work to do when Python could it for me.