Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
11 changes: 8 additions & 3 deletions src/configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,15 @@ aw-client
aw-watcher-afk
--------------

- ``timeout`` Time in seconds after which a period without keyboard or mouse activity is considered to be AFK (away from keyboard).
- ``poll_time`` Time in seconds between checks for activity.
- ``timeout`` Time in seconds after which a period without keyboard or mouse activity is considered to be AFK (away from keyboard). The default is ``180`` seconds.
- ``poll_time`` Time in seconds between checks for activity. The default is ``5`` seconds.

See `aw_watcher_afk/config.py <https://github.com/ActivityWatch/aw-watcher-afk/blob/master/aw_watcher_afk/config.py>`_ for the default config values.
These settings live in ``aw-watcher-afk/aw-watcher-afk.toml``, the config file for the ``aw-watcher-afk`` component, not in the ActivityWatch web UI settings page.
You can open the config folder from the ActivityWatch tray menu, or use the :ref:`config directory <config-directory>` for your platform.
If a setting is commented out in the file, remove the leading ``#`` before changing it.
After saving the file, restart ActivityWatch or ``aw-watcher-afk`` for the change to take effect.

See `aw_watcher_afk/config.py <https://github.com/ActivityWatch/aw-watcher-afk/blob/master/aw_watcher_afk/config.py>`_ for the source of the default config values.

aw-watcher-window
-----------------
Expand Down
12 changes: 12 additions & 0 deletions src/faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,18 @@ Using this data (seconds since last input) we check if more than 3 minutes have

If the browser watcher is running, the user will also by default be considered to not be AFK when the active browser tab has sound playing from it. This helps when the user for example watches a video or is in a video/audio meeting.

Can I change when ActivityWatch marks me as AFK?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Yes. The default AFK timeout is 3 minutes. To change it, open the ActivityWatch tray menu, choose the option to open the config folder, then edit ``aw-watcher-afk/aw-watcher-afk.toml``. Set ``timeout`` to the number of seconds without keyboard or mouse activity before ActivityWatch should mark you as AFK.
For example, ``timeout = 300`` marks you as AFK after 5 minutes.

If the setting is commented out, remove the leading ``#`` before saving.
After saving the file, restart ActivityWatch or ``aw-watcher-afk`` for the change to take effect.

If idle or locked-screen time is still counted as active time, first check that ``aw-watcher-afk`` is running and that the Timeline view shows an ``afk`` period while you are away.
See :doc:`configuration` for the related ``aw-watcher-afk`` options.

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

Expand Down