matrix-docker-ansible-deploy/docs/configuring-playbook-bridge-mx-puppet-steam.md

30 lines
1.2 KiB
Markdown
Raw Normal View History

# Setting up MX Puppet Steam bridging (optional)
2020-07-01 11:46:58 +00:00
The playbook can install and configure [mx-puppet-steam](https://github.com/icewind1991/mx-puppet-steam) for you.
2020-07-01 11:46:58 +00:00
See the project page to learn what it does and why it might be useful to you.
## Adjusting the playbook configuration
2020-07-01 11:46:58 +00:00
To enable the [Steam](https://steampowered.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:
2020-07-01 11:46:58 +00:00
```yaml
matrix_mx_puppet_steam_enabled: true
```
## Installing
After configuring the playbook, run the [installation](installing.md) command: `just install-all` or `just setup-all`
2020-07-01 11:46:58 +00:00
## Usage
Once the bot is enabled you need to start a chat with `Steam Puppet Bridge` with the handle `@_steampuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain).
2020-07-01 11:46:58 +00:00
Three authentication methods are available, Legacy Token, OAuth and xoxc token. See mx-puppet-steam [documentation](https://github.com/icewind1991/mx-puppet-steam) for more information about how to configure the bridge.
2020-07-01 11:46:58 +00:00
Once logged in, send `list` to the bot user to list the available rooms.
Clicking rooms in the list will result in you receiving an invitation to the bridged room.
2020-07-01 11:46:58 +00:00
Also send `help` to the bot to see the commands available.