Skip to content

RoyalHighgrass/WokeApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WokeApp v1.0 © 2025 P.H.

An Idle System Prevention Tool (ISPT)

Project Overview

WokeApp is a lightweight utility that prevents Linux systems from idling. It simulates user activity, such as mouse movements or keyboard input, to keep the system active. WokeApp is configurable, allowing users to define the type and frequency of simulated activity. It also offers flexible scheduling, so users can automate idle prevention. WokeApp is designed to be efficient and unobtrusive, consuming minimal system resources. It's compatible with various Linux desktop environments and offers logging and monitoring capabilities. WokeApp is ideal for users who need to maintain continuous uptime or prevent interruptions caused by system idle states.

Installation

Install with the follwing commands:

sudo apt update
sudo apt install git python3 python3-venv
cd ~/
git clone https://github.com/RoyalHighgrass/WokeApp.git
cd WokeApp
sudo mv wokeapp /usr/bin/
sudo chmod +x /usr/bin/wokeapp
python3 -m venv venv
source venv/bin/activate
python -m pip install --upgrade setuptools pynput
deactivate
cd ~/

Usage

To start the program run the following terminal command:

wokeapp [-h] [-a] [-i INTENSITY] [-k] [-m] [--key KEY]

OPTIONS:
    -a:                 Auto start. Not yet implemented. Coming soon!
    -h, --help:         Show this message.
    -i, --intensity:    Set intensity level. Intesity values range from
                        1 (passive) to 5 (active). The default is 1.
    -k:                 Enable key press.
    --key:              Specify key to use.
    -- uninstall:       Uninstall WokeApp.

INTENSITY=INTEGER (e.g. 1-5, default=1)
KEY=STRING (e.g. k/ctrl/shift/f11, default="scroll_lock")

Privacy & System Security

My two main goals when developing this application were;

  • Prevent my system from idling while installing, updating, compiling, or testing some software.

An easy and pretty obvious solution would just be to disable the screen lock splash screen, or configure the system to never go to sleep, or just completely disable the need to sign in. However, this raises some easily avoidable security issues, namely, potentially unlimited access to anyone in physical possession of your computer or device.

  • Create something that is useful and considered "Safe to use" by anyone who uses it.

From a cybersecurity perspective, I would like to think that this is something I have achieved.

Uninstall

If you find that you need to uninstall WokeApp, you can do so by running the following command:

wokeapp --uninstall