Appnope

0.1.4 · maintenance · verified Thu Apr 09

Appnope is a small Python library for macOS (10.9 and later) that disables App Nap for the current process. It is primarily used in long-running Python applications and interactive environments like Jupyter notebooks to prevent them from being suspended when in the background. The current version is 0.1.4, and the library is in maintenance, receiving updates mainly for compatibility.

Warnings

gotcha Appnope is a macOS-specific library. It will not have any effect or may raise platform-specific errors if run on non-macOS operating systems.
Fix: Ensure your environment is macOS (version 10.9 or later) when using appnope. It's advisable to guard its import with platform checks if your code needs to run on multiple OSes (e.g., `if sys.platform == 'darwin': import appnope`).
gotcha App Nap itself only exists on macOS 10.9 (Mavericks) and later. Using `appnope` on older macOS versions will have no effect related to App Nap, though the library might still import.
Fix: Be aware of the target macOS version. The library's utility is limited to macOS 10.9+.
gotcha Appnope disables App Nap only for the *current* process. If your Python application spawns child processes (e.g., using `subprocess` or `multiprocessing`), those child processes will not automatically inherit the App Nap disabled state and may still be subject to App Nap.
Fix: If child processes also need App Nap disabled, you must import `appnope` within those child processes' entry points or apply equivalent OS-level settings.
gotcha The primary effect of `appnope` occurs immediately upon `import appnope`. It's not a function call that you explicitly make after import (unless you use `set_appnap_enabled`).
Fix: Simply placing `import appnope` at the beginning of your script or interactive session is sufficient to disable App Nap for that process.

Install

pip install appnope Install stable version

Imports

appnope
```
import appnope
```
The primary way to use appnope; importing it automatically disables App Nap for the current process.
set_appnap_enabled
```
import appnope
appnope.set_appnap_enabled(False)
```
Used to explicitly toggle App Nap status after initial import, or if you wish to re-enable it.

Quickstart

The simplest way to use appnope is to import it. This will automatically disable App Nap for the current Python process on supported macOS versions. For more granular control, `set_appnap_enabled()` can be used.

import appnope
import time

print("App Nap is now disabled for this process (macOS 10.9+).")
print("Sleeping for 10 seconds. Check activity monitor if App Nap usually affects this process.")

time.sleep(10)

# To explicitly re-enable or disable App Nap later:
# appnope.set_appnap_enabled(True) # Re-enable App Nap
# appnope.set_appnap_enabled(False) # Disable App Nap again

print("Done. App Nap status remains as last set.")

view raw JSON →