MyGirlfriendIsAsleep
is a planned cross-platform script designed to help users turn off their physical displays with the option to automatically turn them back on at a specified time. Especially useful when you want to keep your room dark while streaming content! This will probably require use of a hardware EDID emulator (aka Headless dongle).
- Cross-Platform: Will eventually work on Windows and Linux. Potential macOS support in the future
- Dependency Checks: Automatically verifies the presence of required tools and provides installation guidance.
- Delayed Monitor Activation: With the
--shesasleepuntil
flag, set a specific time for the monitors to reactivate. Use--force
to turn on the display before the set time.
To run the executable:
-
Turn off the display:
./mygirlfriendisasleep off
-
Turn on the display:
./mygirlfriendisasleep on
-
Turn off the display and turn it back on at a specified time (e.g., 2:25 PM):
./mygirlfriendisasleep off --shesasleepuntil 14:25
-
Turn on the display forcibly (useful after setting a
--shesasleepuntil
time):./mygirlfriendisasleep on --force
This script interacts with or can trigger the installation of the following software:
-
nircmd (Windows)
- Description: A command-line utility for various tasks without a user interface.
- License: Freeware by NirSoft. Redistribution is permitted, but selling without permission is prohibited.
- NirSoft nircmd
-
caffeinate (macOS)
- Description: A built-in macOS command to prevent the system from sleeping.
- License: Part of Apple's proprietary macOS. No redistribution.
-
xset (Linux)
- Description: A utility from the
x11-xserver-utils
package, providing user access to several X server settings. - License: Typically under the MIT License.
- X.Org xset
- Description: A utility from the
MyGirlfriendIsAsleep
is licensed under the LGPLv3. Please adhere to the terms of the LGPLv3 when using or redistributing this software.
Third-party tools that the script interacts with have their own licenses, as detailed above. While the script does not redistribute any third-party software, it can facilitate their installation or usage.
Contributions, suggestions, and issues are welcome! Open an issue or pull request on the project's repository.
Developed with ❤️ by KTheMan.