1LINK RELAY TOOL
2===============
3
4The Link Relay is a WebSocket relay, which acts like an online chat system, where each "chat room" can be joined by multiple virtual controllers, which can then communicate with each other, as if connected with radio communication.
5
6```
7usage: python link_relay.py [-h] [--log-level LOG_LEVEL] [--log-config LOG_CONFIG] [--port PORT]
8
9optional arguments:
10  -h, --help            show this help message and exit
11  --log-level LOG_LEVEL
12                        logger level
13  --log-config LOG_CONFIG
14                        logger config file (YAML)
15  --port PORT           Port to listen on
16```
17
18(the default port is `10723`)
19
20When running, the link relay waits for connections on its listening port.
21The WebSocket path used by a connecting client indicates which virtual "chat room" to join.
22
23
24!!! tip "Connecting to the relay as a controller"
25    Most of the examples and tools that take a transport moniker as an argument also accept a link relay moniker, which is equivalent to a transport to a virtual controller that is connected to a relay.
26    The moniker syntax is: `link-relay:ws://<hostname>/<room>` where `<hostname>` is the hostname to connect to and `<room>` is the virtual "chat room" in a relay.
27
28    Example: `link-relay:ws://localhost:10723/test` will join the `test` "chat room"
29
30!!! tip "Connecting to the relay as an observer"
31    It is possible to connect to a "chat room" in a relay as an observer, rather than a virtual controller. In this case, a text-based console can be used to observe what is going on in the "chat room". Tools like [`wscat`](https://github.com/websockets/wscat#readme) or [`websocat`](https://github.com/vi/websocat) can be used for that.
32
33    Example: `wscat --connect ws://localhost:10723/test`
34