aboutsummaryrefslogtreecommitdiff
path: root/jsmond.rst
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2020-05-18 23:59:51 -0400
committerB. Watson <yalhcru@gmail.com>2020-05-18 23:59:51 -0400
commit005fc7dcf69fc112b5ce3d2c4017769cd8e425e8 (patch)
tree88b902b56f30ed80e4ffd0f7dbeeaf62da6cfcaf /jsmond.rst
parent045f4601b352abc2955050bd273b46ad602f3bad (diff)
downloadunsaver-005fc7dcf69fc112b5ce3d2c4017769cd8e425e8.tar.gz
detect fullscreen windows (-f/-F)
Diffstat (limited to 'jsmond.rst')
-rw-r--r--jsmond.rst20
1 files changed, 13 insertions, 7 deletions
diff --git a/jsmond.rst b/jsmond.rst
index 89b47a6..4c0a38d 100644
--- a/jsmond.rst
+++ b/jsmond.rst
@@ -20,13 +20,14 @@ deactivate screensaver on joystick activity
SYNOPSIS
========
-jsmond [**-i interval[s|ms]**] [**-m** | **-k keycode** | **-b button**] [**-d dir**] [**-j name**] [**-D**] [**joydev [joydev ...]**]
+jsmond [**-i interval[s|ms]**] [**-m** | **-k keycode** | **-b button** | **-c command** | **-x** ] [**-d dir**] [**-j name**] [**-f**] [**-F**] [**-D**] [**joydev [joydev ...]**]
DESCRIPTION
===========
-jsmond lets you play games with your joysticks/gamepads without
-the screen saver activating due to lack of keyboard/mouse input.
+jsmond lets you play games with your joysticks/gamepads without the screen
+saver activating due to lack of keyboard/mouse input. It can also prevent
+the screensaver from activating when a fullscreen window is in use.
Multiple joystick devices can be monitored. By default, jsmond
monitors up to 16 devices, named /dev/input/js0 through js15.
@@ -77,15 +78,17 @@ OPTIONS
-c <command> Run a command when activity is detected, rather than
sending a fake keystroke/click/motion. It's recommended
- to set *interval* to at least 1 second, when using this
- option.
+ to set *interval* to at least 1 second when using this
+ option, to avoid excess process-spawning overhead.
-x Same as **-c "xscreensaver-command -deactivate" -i 1s**.
--f Disable screensaver if a full-screen window is detected.
- This isn't likely to be 100% reliable.
+-f Deactivate screensaver if a fullscreen window is detected.
+ This isn't likely to be 100% reliable yet.
-F Same as **-f**, but also disables joystick monitoring entirely.
+ Note that **-j**, **-d**, and **joydev** are ignored
+ with this option.
These options are intended for developers and *really* shouldn't be
needed for normal use:
@@ -132,6 +135,9 @@ jsmond depends on the XTest extension being present in the X server. If
you get a "X server doesn't support XTest extension" error, see your X
server documentation to find out how to enable XTest.
+The fullscreen window monitoring has only been tested on a system with
+a single monitor, and may not work properly in multi-head environments.
+
EXIT STATUS
===========