67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# obsdc
|
|
|
|
OBS control from D-Bus messages
|
|
|
|
Send a D-Bus signal to perform an operation with `src/obsdc-signal`, which takes a single operation name
|
|
as an argument.
|
|
|
|
## Operations
|
|
|
|
See [Op](src/main/kotlin/net/eksb/obsdc/Op.kt) for a list of operations.
|
|
|
|
## Configuration
|
|
|
|
Configuration is read from `$XDG_CONFIG_HOME/net.eksb.obsdc/config.properties`
|
|
|
|
### Configuration options
|
|
|
|
* `host` - OBS websocket host (default: `localhost`)
|
|
* `port` - OBS websocket port (default: `4455`)
|
|
* `password` - OBS websocket password (required)
|
|
|
|
### systemd
|
|
|
|
A systemd unit file ([obsdc.service](src/main/dist/obsdc.service)) is included.
|
|
|
|
1. Copy the file to `~/.config/systemd/user/`.
|
|
2. Edit the `ExecStart` line for where you have installed obsdc.
|
|
3. `systemctl --user enable obsdc`
|
|
4. `systemctl --user start obsdc`
|
|
|
|
## Build
|
|
|
|
`gradle build`
|
|
|
|
## Run
|
|
|
|
1. `tar xf build/distributions/obsdc.tar`
|
|
2. `cd obsdc`
|
|
3. Create config file. See [#Configuration].
|
|
4. `bin/obsdc`
|
|
5. `bin/obsdc-signal` to send an op.
|
|
|
|
## Code
|
|
|
|
Start at [Main](src/main/kotlin/net/eksb/obsdc/Main.kt).
|
|
|
|
[Obs](src/main/kotlin/net/eksb/obsdc/Obs.kt) is a wrapper around
|
|
[obs-websocket-java](https://github.com/obs-websocket-community-projects/obs-websocket-java)
|
|
that handles reconnects and queuing operations until the websocket it ready.
|
|
|
|
[OpRunner](src/main/kotlin/net/eksb/obsdc/OpRunner.kt) has the logic to run [Op](src/main/kotlin/net/eksb/obsdc/Op.kt)s
|
|
using an `Obs`.
|
|
|
|
[DBus](src/main/kotlin/net/eksb/obsdc/DBus.kt) listens for the `D-Bus` signals and calls `OpRunner`.
|
|
|
|
## History/Rationale
|
|
|
|
I usually code on a 4k monitor in portrait mode. To show what I am doing on video calls,
|
|
I use OBS to share that monitor, but it is a 2160x4096 source in a 1920x1080 scene.
|
|
|
|
I have [a macropad](https://www.keebmonkey.com/products/megalodon-dual-layer-knob-macro-pad) with two knobs.
|
|
My [window manager](https://swaywm.org/) is configured to call `obsdc-signal` with `PAN_UP`/`PAN_DOWN` for the
|
|
keys emitted by one knob and `PAN_RIGHT`/`PAN_LEFT` for the keys emitted by the other knob.
|
|
The regular keys on the macropad are mapped to the other actions.
|
|
|
|
So now I can quickly control what people can see without having to focus (or even make visible) the OBS window.
|