-
Notifications
You must be signed in to change notification settings - Fork 20
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
53 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
AutoOculusTouch - Helper library to provide AutoHotKey with Oculus Touch state. | ||
Copyright (C) 2017 Kojack ([email protected]) | ||
|
||
AutoOculusTouch is released under the MIT License | ||
https://opensource.org/licenses/MIT | ||
|
||
|
||
AutoOculusTouch is a library and script for AutoHotKey. It allows you to read the state of oculus controller devices (Touch, Remote or XBox controller) from within an AutoHotKey script. | ||
|
||
Prerequisites | ||
You must have AutoHotKey installed. It is available from https://autohotkey.com | ||
(AutoOculusTouch is tested against AutoHotKey version 1.1.24.04) | ||
|
||
|
||
Change History | ||
v0.1.1 - Initial release. Built against Oculus SDK 1.10 | ||
v0.1.2 - Added capacitive sensor support. Built against Oculus SDK 1.20 | ||
|
||
|
||
Installation | ||
AutoOculusTouch can be placed anywhere. No explicit installation is required. | ||
There are two files included in the AutoOculusTouch binary release: | ||
- auto_oculus_touch.dll (A library that wraps around the Oculus SDK. | ||
- oculus_touch.ahk (An AutoHotKey script that calls auto_oculus_touch.dll) | ||
You should keep these two files together. | ||
|
||
|
||
Running | ||
To start AutoOculusTouch, double click on the oculus_touch.ahk script. A green icon with a white H should appear in your system tray. AutoOculusTouch is now running. | ||
|
||
|
||
Customising | ||
The provided script has some example behaviour already defined. You can change any of this. Currently it does the following: | ||
- Right thumbstick moves the windows mouse cursor. | ||
- Touch X button and right Touch index trigger both control the left mouse button. | ||
- Up and down on the Oculus remote do media previous and next (track selection in programs like Spotify) | ||
|
||
In the script, search for the "; Now to do something with them." comment. Below this are all the behaviours. | ||
|
||
AutoOculusTouch can give you: | ||
- index and hand triggers of a Touch, as floats from 0.0 to 1.0. | ||
- thumbstick axes as floats from -1.0 to 1.0. | ||
- all Touch, Remote and XBox buttons. | ||
- all Touch capacitive sensors. | ||
- all Touch capacitive gestures (index pointing and thumbs up for either hand). | ||
|
||
|
||
Important Notes | ||
Due to the way the Oculus SDK works, running AutoOculusTouch will make Oculus Home or Dash think that a VR application is running that isn't rendering. The original intent was for AutoOculusTouch to run when no headset is being worn, such as using the Oculus Remote for controlling a PC for media playback, so this didn't matter. Running both AutoOculusTouch and another VR application at the same time probably shouldn't work, but it currently seems to. | ||
|
||
What does this mean? Well, Oculus Home and Dash refuse to run a VR app while another is already running. But you can still run multiple apps at once if you start them using a means besides Home or Dash (such as explorer). | ||
|
||
|