ForceNap - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #golang #android #machine-learning #linux #macos #cli #kubernetes #awesome-list #security #ios #mcp #openai

ForceNap

(★ 382)

Suspend any one Mac OS apps when not in focus

File Explorer

Download Latest Version (.zip)

- - landing-page.css
  - landing-page.min.css
- - bg-masthead.jpg
  - bg-showcase-1.jpg
  - bg-showcase-1.png
  - bg-showcase-2.jpg
  - bg-showcase-3.jpg
  - testimonials-1.jpg
  - testimonials-2.jpg
  - testimonials-3.jpg
- - _call-to-action.scss
  - _footer.scss
  - _global.scss
  - _icons.scss
  - _masthead.scss
  - _mixins.scss
  - _showcase.scss
  - _testimonials.scss
  - _variables.scss
  - landing-page.scss
- gulpfile.js
- index.html
- LICENSE
- package-lock.json
- package.json
- README.md
.gitignore
_config.yml
ForceNap.py
ForceNap_screen_shot.png
LICENSE
nap_my_app.py
README.md
setup.py

# Installation Guide

1. Get the code

git clone https://github.com/omikun/ForceNap

Downloads the entire project code from GitHub to your computer.

cd ForceNap

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install .

Installs the package published on PyPI directly — no need to clone the source.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ForceNap
Useful for times when you want to keep a battery-hogging application running in the background to switch to intermittently, but don't want to pay the battery penalty of keeping it running when you don't need it. Examples include Unity, Matlab, Civilization, etc.

- Force one or more apps to stop when not in focus and resumes each app when they regain focus.
- This script runs every 0.5 second, but otherwise should introduce no additional lag. 
- Apps that are ForceNapped cannot be interacted with in the background (scroll with another app in focus).
- You may see spinning beachball over ForceNapped apps and they will show as "Not responding" in Activity Monitor. Click on the app or alt-tab back to it to resume the app.
- Suspend only stops the app from using CPU but keeps data in memory.

This differs from App Nap which throttles and potentially stops apps, but only if they are supported.

## Usage:
- Download the pre-release [ForceNap](https://github.com/omikun/MyAppNap/releases)
- Open and select the application(s) to force nap in the status bar (look for FN). 
![Screen shot](https://raw.githubusercontent.com/omikun/ForceNap/master/ForceNap_screen_shot.png)

## Limitations:
- ForceNap does not support when target application spawns a new window.
- ForceNap must be started after target applications have been started. 
- This is not a stable product yet. 
- Not suited for mission critical applications.

## Compile 
You can also compile your own using [rumps](https://github.com/jaredks/rumps/blob/master/rumps/rumps.py) and py2app.

python setup.py py2app
    
### Deprecated:
Start desired app, then run script with one or more app names as arguments:`python nap_my_app.py app_name(s)`

For example, to suspend Unity and Safari:

python nap_my_app.py Unity Safari

If no argument is given, all defocused apps (apps that get focus then lose it) are automatically suspended.

On exit, all suspended apps will be resumed.

Tested in Mac OS Sierra

## TODO:

- Done - Disallow suspending Terminal (useful if you're launching from Terminal)
    - DONE - do nothing if invalid name given
    - DONE - Integrate with rumps so this can be accessed from the status bar instead of terminal
    - DONE - Select multiple apps to nap at the same time
    - Refactor code
    - Dynamically update menu
    - Handle new windows spawned by target applications
    - Handle target application shutdown