qtile / qtile / 29548019229
83%

DEFAULT BRANCH: master
Ran
Jobs 6
Files 156
Run time 1min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 83.157% (-0.005%) from 83.162%
29548019229

push

github

tych0 
docs: recommend launching qtile via a systemd user service

Since many applications are moving towards portals (flatpak, browsers for
screen sharing, etc.) for interoperability and graphical-session.target is
being used now for autostarting things that were historically started by
the DM directly (e.g. ssh-agent.socket), start recommending a systemd-based
approach for starting qtile.

I dropped any recommendation about xsession from the x11 bits, in favor of
unifying the way we start Qtile across both x11 and wayland, since it is
getting more complicated. xsession is not really necessary for anything
since Qtile has autostart support, and it still works fine, but is not
necessarily the recommended way to do things any more.

Some annoyances:

* user services are not forked from the login shell:
  https://github.com/emersion/xdg-desktop-portal-wlr/wiki/systemd-user-services,-pam,-and-environment-variables#thats-annoying-why-are-user-services-not-forked-from-my-login-shell
  so the recommended way to get things is to do a `systemctl
  --user import-environment` from the service.
* bare `import-environment` is deprecated
* the .desktop spec does not have support for line continuations

this means that we have to have one big long line of everything interesting
to import in the .desktop file. We could use a separate shell script to do
the line continuation, but then that is another thing for people to
install, reason about a path to, etc.

I pulled the list of environment variables via claude from:

    loginctl session-status

it is entirely possible there are other interesting variables, though it
seems like static things should go in ~/.config/environment.d.

Finally, this commit relies on Qtile autodetecting the backend so that we
can use the same entrypoint everywhere.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

17315 of 20822 relevant lines covered (83.16%)

4.52 hits per line

Coverage Regressions

Lines Coverage ∆ File
1
71.01
 -0.72% libqtile/widget/volume.py
Jobs
ID Job ID Ran Files Coverage
1 3.12-x11 - 29548019229.1 156
76.8
 GitHub Action Run
2 3.14-x11 - 29548019229.2 156
76.78
 GitHub Action Run
3 3.13-wayland - 29548019229.3 156
73.73
 GitHub Action Run
4 3.12-wayland - 29548019229.4 156
73.74
 GitHub Action Run
5 3.13-x11 - 29548019229.5 156
76.8
 GitHub Action Run
6 3.14-wayland - 29548019229.6 156
73.74
 GitHub Action Run
Source Files on build 29548019229