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/disableKEYBOARD_BLOCK=TrueMOUSE_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 modeUNLOCK_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 idlingIGNORE_FULLSCREEN_APPLICATIONS=True# For the above parameter, this also requires it to be focusedONLY_IGNORE_FOCUSED_FULLSCREEN_APPLICATIONS=True# Applications that aren't considered full-screen even if they areIGNORED_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.