/acpi-sleep

Toggle wakeup by ACPI of a Linux machine from USB device activity. Limit wakeup to Power buttons and/or other devices. systemd service.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

ACPI Sleep

v1.0.0

Toggle wakeup by ACPI of a Linux machine from USB device activity. Limit wakeup to Power buttons and/or other devices. systemd service.

Latest release | View develop branch...

Table of Contents

Why?

Allow or deny mouse movement, key presses, controller input, etc., from waking a Linux desktop.

As far as I know, the Linux desktop environments (KDE Plasma, GNOME, etc.) do not have any method or guide for this functionality. However, this is accessible to desktop users in Microsoft Windows.

Download

  • To download this script, you may:

    • Download the ZIP file:

      1. Viewing from the top of the repository's (current) webpage, click the green <> Code drop-down icon.
      2. Click Download ZIP. Save this file.
      3. Open the .zip file, then extract its contents.

    • Clone the repository:

      1. Open a Command Line Interface (CLI).
      • Open a console emulator (for Debian systems: Konsole).
      • Open a existing console: press CTRL + ALT + F2, F3, F4, F5, or F6.
        • To return to the desktop, press CTRL + ALT + F7.
        • F1 is reserved for debug output of the Linux kernel.
        • F7 is reserved for video output of the desktop environment.
        • F8 and above are unused.
      1. Change your directory to your home folder or anywhere safe: cd ~
      2. Clone the repository: git clone https://www.github.com/portellam/acpi-sleep

  • To make this script executable, you must:

    1. Open the CLI (see above).
    2. Go to the directory of where the cloned/extracted repository folder is: cd name_of_parent_folder/acpi-sleep/
    3. Make the installer script file executable: chmod +x installer.bash
    • Do not make any other script files executable. The installer will perform this action.
    • Do not make any non-script file executable. This is not necessary and potentially dangerous.

Host Requirements

  • systemd for system services.

Usage

1. installer.bash

  • From within the project folder, execute: sudo bash installer.bash
  -d, --disable Disable wakeup by USB devices at startup.
  -e, --enable  Enable wakeup by USB devices at startup.
  --uninstall   Uninstall all source files from system, and remove related startup services.
  -h, --help    Print this help and exit.

2. acpi-sleep

  • Execute the installer: sudo bash installer.bash
  • Or, from any folder execute: sudo bash acpi-sleep
    • The CLI's shell (bash) should recognize that the script file is located in /usr/local/bin.
  -d, --disable Disable wakeup by USB devices for this session.
  -e, --enable  Enable wakeup by USB devices for this session.
  -h, --help    Print this help and exit.

Disclaimer

Default behavior of a system is to allow system wakeup by USB. Therefore, installing the Systemd service to enable wakeup by USB, is not necessary.

Should your system not have...

  • a Power button
  • Wake-on-LAN (with an active Network connection)
  • scheduled wakeup times
  • Remote administration
  • etc.

then this script may prevent system resume. Please, evaluate your system before installation.

Contact

Did you encounter a bug? Do you need help? Notice any dead links? Please contact by raising an issue with the project itself.