diff --git a/src/configuration.rst b/src/configuration.rst index b2b746e..022b2a1 100644 --- a/src/configuration.rst +++ b/src/configuration.rst @@ -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 `_ 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 ` 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 `_ for the source of the default config values. aw-watcher-window ----------------- diff --git a/src/faq.rst b/src/faq.rst index bf3af26..3312ed3 100644 --- a/src/faq.rst +++ b/src/faq.rst @@ -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? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~