aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
diff options
context:
space:
mode:
authorPřemysl Eric Janouch <p@janouch.name>2025-01-22 13:06:36 +0100
committerPřemysl Eric Janouch <p@janouch.name>2025-01-22 13:25:39 +0100
commit32ea9349477d6c88c05dc34855e104a704b5eb3f (patch)
tree8dc72c61462aaca17781cd57bb72bd82eb81d242 /README.adoc
parent55984bc7ef0b6e1b5992019d3aa3d25de8d08159 (diff)
downloadusb-drivers-32ea9349477d6c88c05dc34855e104a704b5eb3f.tar.gz
usb-drivers-32ea9349477d6c88c05dc34855e104a704b5eb3f.tar.xz
usb-drivers-32ea9349477d6c88c05dc34855e104a704b5eb3f.zip
Update README.adoc
Diffstat (limited to 'README.adoc')
-rw-r--r--README.adoc44
1 files changed, 44 insertions, 0 deletions
diff --git a/README.adoc b/README.adoc
index 99f8c74..98bf6bf 100644
--- a/README.adoc
+++ b/README.adoc
@@ -1,6 +1,7 @@
USB drivers
===========
:compact-option:
+:source-highlighter: chroma
_usb-drivers_ is a collection of utilities to control various hardware over USB.
@@ -26,6 +27,49 @@ it will also suspend or power off the system, respectively.
image:eizoctltray-win.png["eizoctltray on Windows with expanded menu", 343, 278]
image:eizoctltray-mac.png["eizoctltray on macOS with expanded menu", 343, 278]
+Installation
+^^^^^^^^^^^^
+On Windows, copy it to
+__Users\*\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup__.
+
+On macOS, copy it to the _Applications_ folder,
+then add it in _System Settings → General → Login Items → Open at Login_.
+
+Automation
+^^^^^^^^^^
+_eizoctltray_ can also be used the same way as _eizoctl_, just with any output
+redirected to message windows, rather than a console window or a terminal.
+This is useful for automation, such as with AutoHotkey.
+
+Beware that Windows is not a fan of how rapidly EIZO monitors switch upstream
+USB ports. Thus, if you invoke port switching with keyboard shortcuts,
+remember to add a small delay, so that pressed modifier keys are not remembered.
+You will also want to silence any error messages.
+
+.AutoHotkey example
+```autohotkey
+#Requires AutoHotkey v2.0
+exe := A_Startup . "\eizoctltray.exe"
+^#F1:: { ; Windows + Control + F1
+ Sleep 500
+ Run exe " -qq --input HDMI"
+}
+^#F2:: { ; Windows + Control + F2
+ Sleep 500
+ Run exe " -qq --input DP"
+}
+^#F3:: { ; Windows + Control + F3
+ Sleep 500
+ Run exe " -qq --input USB-C"
+}
+#Home:: { ; Windows + Home
+ Run exe " -q --brightness +0.1"
+}
+#End:: { ; Windows + End
+ Run exe " -q --brightness -0.1"
+}
+```
+
elksmart-comm
~~~~~~~~~~~~~
_elksmart-comm_ interfaces with ELK Smart infrared dongles EKX4S and EKX5S-T,