nosleepy 2.0.0

Keep your system active by simulating mouse, keyboard, or typed input at configurable intervals

nosleepy

Keep your system active with realistic typed input simulation — types random phrases into a hidden invisible window, never your active window.

---

Quickstart

pip install nosleepy
nosleepy -m xlib --pause 37 --words 30

---

Install

pip install nosleepy

# or
pip3 install nosleepy

Via Snap

sudo snap install nosleepy

Run (recommended)

nosleepy -m xlib --pause 37 --words 30

---

Modes

Mode	What it does
xlib	Types phrases into a hidden 1×1 invisible window — no GUI trace (recommended)
xdotool	Types phrases into a minimized sink xterm window
mouse	Moves mouse diagonally (default)
keyboard	Presses Shift key
both	Mouse + Shift
scroll	Scrolls mouse wheel

---

All Options

-m MODE, --mode MODE            xlib (recommended), xdotool, mouse, keyboard, both, scroll
--pause SECONDS                 Fixed pause between typed phrases. e.g. --pause 37
--words MAX or MIN MAX          Words per phrase. e.g. --words 30 or --words 20 30. Default: 20 30
-s SECONDS, --seconds SECONDS   Idle wait seconds for mouse/keyboard modes. Default: 300
-p PIXELS, --pixels PIXELS      Pixels to move mouse. Default: 1
-c, --circular                  Move mouse in a circle
-r MIN MAX, --random MIN MAX    Random interval. e.g. -r 30 60
-a LEVEL, --activity LEVEL      Activity % for xlib/xdotool (50-95). Default: 75
--version                       Show version
-h, --help                      Show help

---

Examples

# Recommended
nosleepy -m xlib --pause 37 --words 30

# Shorter phrases
nosleepy -m xlib --pause 37 --words 15

# Faster cadence
nosleepy -m xlib --pause 20 --words 30

# Move mouse every 60 seconds
nosleepy -m mouse -s 60

# Run for 2 hours then stop
timeout 2h nosleepy -m xlib --pause 37 --words 30

# Stop anytime
Ctrl + C

---

FAQ

Does it work on Wayland?

No. Run on X11 or use XWayland.

Does it affect my active window?

No. xlib mode creates an invisible off-screen window. Keystrokes never reach your active app.

Any memory leak or leftover processes?

No. The hidden window lives only while the process runs. On exit everything is cleaned up automatically.

What is the difference between --pause and --activity?

• --pause — fixed wait between phrases (recommended for human-like cadence)
• --activity — percentage of time spent typing (continuous rapid mode)

Run on startup

GNOME / KDE: Add to Startup Applications:

nosleepy -m xlib --pause 37 --words 30

Systemd:

[Unit]
Description=nosleepy

[Service]
ExecStart=nosleepy -m xlib --pause 37 --words 30
Restart=always

[Install]
WantedBy=default.target

systemctl --user enable --now nosleepy

---

Support

If nosleepy is useful to you, consider buying me a coffee!

---

Links

• PyPI: https://pypi.org/project/nosleepy/
• Snap: sudo snap install nosleepy
• GitHub: https://github.com/it-harsh/nosleepy
• Changelog: CHANGELOG.md