Skip to content

docs(linux): classic aw-qt bundle runs awatcher on Wayland from v0.14.2 #218

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
TimeToBuildBob wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs(linux): classic aw-qt bundle runs awatcher on Wayland from v0.14.2 #218

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions src/faq.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,8 @@ The one exception is the optional, separately installed `aw-import-screentime <h
Apple has said that future macOS versions will only grant Full Disk Access with "very explicit user action", so expect an extra confirmation step there.
You can revoke the permission again at any time in *System Settings → Privacy & Security → Full Disk Access*.

.. _wayland:

Why is the active window logged as "unknown" when using Wayland?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand All @@ -117,6 +119,7 @@ Unfortunately, in Wayland compositors like Gnome's Mutter there is no way at all
- Switch to using X11.
- Try an alternative AFK and window :ref:`watcher <window-watchers>` which supports Wayland.
- Try the experimental Tauri distribution (starting with ``v0.14``), which bundles `awatcher <https://github.com/2e3s/awatcher>`_ on Linux for Wayland support. See :doc:`getting-started`.
- Use the classic Linux distribution from ``v0.14.2`` onwards. It bundles `awatcher <https://github.com/2e3s/awatcher>`_ as ``aw-awatcher``, and on a Wayland session ``aw-qt`` automatically starts it in place of ``aw-watcher-window`` and ``aw-watcher-afk``. Compositor support follows `awatcher's supported environments <https://github.com/2e3s/awatcher#supported-environments>`_: wlroots compositors such as Sway and Hyprland work out of the box, KDE uses a built-in KWin script, and GNOME needs the `Focused Window D-Bus <https://extensions.gnome.org/extension/5592/focused-window-d-bus/>`_ extension for active-window tracking.

You can see the general status of the ability of `getting the active window in Wayland on StackOverflow <https://stackoverflow.com/questions/45465016/how-do-i-get-the-active-window-on-gnome-wayland>`_ or follow `the issue for ActivityWatch tracking the problem <https://github.com/ActivityWatch/activitywatch/issues/92>`_.

Expand Down
2 changes: 1 addition & 1 deletion src/getting-started.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ Installation


.. note::
Starting with ``v0.14``, each release also offers an experimental Tauri distribution (files named ``activitywatch-tauri-*``). It replaces the ``aw-qt`` tray app, embeds ``aw-server-rust``, and on Linux bundles `awatcher <https://github.com/2e3s/awatcher>`_ for native Wayland support. The classic distribution remains the default.
Starting with ``v0.14``, each release also offers an experimental Tauri distribution (files named ``activitywatch-tauri-*``). It replaces the ``aw-qt`` tray app, embeds ``aw-server-rust``, and on Linux bundles `awatcher <https://github.com/2e3s/awatcher>`_ for native Wayland support. The classic distribution remains the default. From ``v0.14.2``, the classic Linux distribution also bundles awatcher and starts it automatically on Wayland sessions (see :ref:`the Wayland FAQ entry <wayland>`).


Usage
Expand Down
Loading