Skip to content

Repository files navigation

AFKLocker

Lock your PC. Close the lid. Keep it running.

A small Windows utility for people who need the laptop to keep working while they are away.

Build License: MIT

Download · Architecture · Security · Changelog

Double-click AFKLocker, Windows locks, close the lid, everything keeps running

Why

You have a build, a download, a local server or an AI agent running, and you need to leave. Closing the lid normally suspends the machine, so you either leave it open or you stop working.

Windows can be configured not to suspend, but the settings are scattered across Control Panel, easy to get half-right, and nothing tells you whether you got it right. AFKLocker checks them, fixes them if you agree, and gives you a one-action way to lock before you go.

Quick start

  1. Download from Releases — installer, or a portable zip if you would rather not install anything.
  2. Run it. You get an AFKLocker shortcut on your desktop.
  3. Open AFKLocker Setup, check the readiness list, apply the configuration if it asks.
  4. From then on: double-click AFKLocker, close the lid, walk away.

SmartScreen will warn on first run. The binaries are not code-signed — a certificate is a recurring cost this project does not have. Click More info → Run anyway, or verify the download first:

# proves these bytes came from this repository's release workflow
gh attestation verify AFKLocker-<version>-setup.exe --repo augbastos/AFKLocker

Or check the hash against SHA256SUMS.txt from the release. Details in docs/signing.md.

Three ways to lock

How Running while you work?
Manual (default) Double-click the icon Nothing
Global hotkey (opt-in) Press a key you choose A small helper, waiting for the key
Automatic (opt-in) Close the lid A small helper, waiting for the lid

All three do the same thing: lock the session and put the screens out. Both opt-in modes are off until you switch them on in Setup, and they share one helper — switching both on does not run two of them. Turning one off leaves the helper running if the other still needs it.

Whichever mode you use, AFKLocker stays alive while the session is locked to look after the screens, and exits when you sign in.

Opening the lid never unlocks anything. You sign in normally, every time.

The hotkey is not a keyboard watcher

You pick the keys — AFKLocker ships no default. The Menu key, next to the right Ctrl on many keyboards, works on its own and is a good candidate because almost nothing else uses it.

AFKLocker asks Windows to be told when that one combination is pressed, and Windows tells it only that. No other keystroke reaches the program, and none is recorded anywhere. If another program already owns a combination, Setup says so while you are choosing it.

The screens

Locking does not darken a screen on its own, and on some machines Windows never darkens the lock screen at all. So AFKLocker asks for display-off after locking, and keeps asking, because Windows ignores the request while there has been recent input — which is exactly when you have just clicked.

It gives up when you sign back in, and after twelve hours as a backstop. If you open the lid or use the keyboard once the screen has gone dark, it stands off for 90 seconds and starts that again on every further touch, so it will not darken a screen you are working at.

It keeps nothing awake — that is the power configuration's job.

What it changes on your machine

Only these, only on the active power plan, and only after you confirm:

Setting Set to When
Lid close action (plugged in) Do nothing Always
System sleep timeout (plugged in) Never Always
Hibernate timeout (plugged in) Never Only if hibernation is enabled
The same three on battery Only if you tick "also on battery"

Battery is off by default, because keeping a machine awake with the lid shut on battery drains it and can overheat it in a bag. The trade-off: if you use Automatic mode unplugged without ticking battery, closing the lid will lock and then let Windows sleep. Setup says so when that applies to you.

Display timeouts are never written. AFKLocker keeps the system awake, not the screen.

The previous values are backed up in plain text under %LOCALAPPDATA%\AFKLocker before anything is changed. If a change fails partway, AFKLocker puts back the ones that already happened — and if it cannot, it tells you exactly what is still changed instead of reporting a clean failure.

Restore: AFKLocker Setup → Restore previous. Uninstalling always attempts to remove the helper and its startup entry, whether or not you restore the settings, and tells you if it could not.

⚠️ Safety

Never leave a running, lid-closed laptop in a bag, sleeve, drawer or backpack. AFKLocker's whole purpose is to stop the machine sleeping when you shut it, which means it keeps generating heat with its vents against fabric. Setup says this too, before you turn anything on.

A locked machine is still a running machine. AFKLocker locks a session; it does not defend against someone with physical access.

Privacy

No network access of any kind. No telemetry, no analytics, no update check, no server, no account. Nothing about your machine leaves it.

No keyboard monitoring. The hotkey is a registration, not a watcher — see above.

If something does not work, AFKLocker Setup → Diagnostics runs a self-test and can export a zip you can attach to an issue. It is written to disk and never transmitted, and it deliberately excludes your username, computer name, network addresses, files, installed programs and processes. Paths become placeholders. Manufacturer and model are opt-in and start unticked.

Compatibility and limitations

  • Windows 10 (1903+) and Windows 11, x64. Needs .NET Framework 4.8, which both already have. The installer will run on Windows 8.1, but that has not been tested and 4.8 is not there by default.
  • No administrator rights needed, unless Windows refuses a power setting — then Setup offers to elevate and tells you why.
  • No code signing. SmartScreen warns; the attestation above is what exists instead.
  • Physically tested on one machine. Everything else is covered by tests against simulated ones — which is why the diagnostics export exists.
  • Modern Standby (S0 low power idle) is a known gap. Those machines do not use the classic sleep settings AFKLocker configures, so closed-lid behaviour is up to the firmware. Setup detects Modern Standby and says so rather than promising it will work.
  • OEM utilities and Group Policy can override you. Vendor power software may re-apply its own settings, and a managed machine may refuse the changes outright. Setup reports what Windows actually says, so re-check the readiness list if you suspect this.
  • Automatic mode needs a machine that reports lid events. Some laptops have the ACPI Lid device disabled, often deliberately to stop them sleeping. Setup detects that and says so, because otherwise the helper looks perfectly healthy and simply never fires.

Building from source

Needs only Windows. No SDK, no NuGet, no package restore.

git clone https://github.com/augbastos/AFKLocker.git
cd AFKLocker
.\tools\Build.ps1 -Test

More

Something not working? AFKLocker Setup → Diagnostics → Export diagnostics produces a file you can attach to an issue.

License

MIT — see LICENSE.

About

Lock your PC. Close the lid. Keep it running. A small Windows utility that prepares Windows for closed-lid operation and locks the session in one double-click.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages