Inactivity Monitor

A small python app to lock your computer when you're idle on the desktop for too long. No more snoopers!

Installation

Note that this was built for a Windows machine, you cannot run this on a linux machine.

• Install python from Microsoft Store or the Official Python Website. Any version above 3.10 should work, but I used 3.12.

• Run run_install.bat to install all required dependencies

• Run run_python.bat (with console) or run_vbs.vbs (without console) to start the app!

• You may then control the app through the tray icon.

• Optionally, you may add the run_vbs.vbs file to your task scheduler to run on boot!

Options

• You may enable/disable the monitor through the tray icon.

• You may change the following properties in checker.pyw:

# How many seconds to wait before locking 
IDLE_LIMIT = 3

# Modules to enable/disable
KEYBOARD_BLOCK = True
MOUSE_BLOCK = True

# Adds a Komorebi-specific feature where staying on blank workspaces are treated as idling.
KOMOREBI_INTEGRATION_ENABLED = True

# To avoid the ctrl+alt+delete bypass.
# Only works when computer on lockdown, don't worry!
TASK_MANAGER_KILLER = True

"""
Make sure your unlock combination works! See the pynput.Key objects for special keys.
Use NON_LETHAL mode to test that your unlock combination actually works before deploying
"""
# Unlock combination and mode
UNLOCK_COMBINATION = ["o", "p", "p", "o"]

# Nothing gets locked with this mode on, but the rest of the app will work.
NON_LETHAL = False

""" Komorebi specific options """

# When there are full-screen applications, do not assume komorebi idling
IGNORE_FULLSCREEN_APPLICATIONS = True 

# For the above parameter, this also requires it to be focused
ONLY_IGNORE_FOCUSED_FULLSCREEN_APPLICATIONS = True 

# Applications that aren't considered full-screen even if they are
IGNORED_FULLSCREEN_TITLES = [
    "Task Switching",
    # ...
] # You can determine which ones to ignore by running `fullscreen_apps.py`

NOTE

The password by default is "oppo", you will have to type that into your keyboard to unlock your device unless you change it

Adding to task scheduler

• Open up Task Scheduler on your system

• Right click "Task Scheduler Library" and select "Create Basic Task"

• Enter any name for the task

• Trigger when the I log on

• Start a Program

• Click on "Browse" and look for the run_vbs.vbs file

• Put the folder path in the "Start in" option

• If you are on a laptop, might help to disable this

• Done! Every time you start your computer, the inactivity monitor will run

Komorebi Integration

If you use Komorebi on your system, you can turn KOMOREBI_INTEGRATION_ENABLED to True. This adds an additional feature where if you switch to a blank workspace and stay there for too long, it assumes inactivity.

Credits

• The character.png comes from dinopixel.com and the author is Squidgril202. The license of this repo does not cover it.

• The font included in the repository is VCR OSD Mono and the author is Riciery Santos Leal. You may not use this font for commercial purposes.