Skip to content

Files

Latest commit

ba7ff8e · May 6, 2018

History

History
41 lines (32 loc) · 1.28 KB

README.md

File metadata and controls

41 lines (32 loc) · 1.28 KB

Blank Detector Task Controller

A tool for running commands only when the display is blank or locked.

Requirement

  • Linux
  • Python 2.7 or 3.x
  • One of these for display status detector
    • DPMS enabled X environment (Please check by 'xset q|grep DPMS')
    • 'xscreensaver-command' for xscreensaver status

Usage

$ ./blank_detector.py -h
usage: blank_detector.py [-h] [-d DISPLAY] -c COMMAND
                         [-m {DpmsDetector,XscreensaverDetector}] [-l LOG]

optional arguments:
  -h, --help            show this help message and exit
  -d DISPLAY, --display DISPLAY
                        For detecting display blank, specify target display
                        name in format ':0.0' (default is taken from $DISPLAY)
  -c COMMAND, --command COMMAND
                        Set a command to execute
  -m {DpmsDetector,XscreensaverDetector}, --module {DpmsDetector,XscreensaverDetector}
                        Select detector module for display status (default:
                        DpmsDetector)
  -l LOG, --log LOG     Set log file path for logging

Example

$ ./blank_detector.py -d ':0.0' -c 'command.sh arg1 arg2' -m DpmsDetector -l /path/to/app.log
$ ./blank_detector.py -d ':0.0' -c 'command.sh arg1 arg2' -m XscreensaverDetector -l /path/to/app.log