turntie-cli

This tool demostrates usage of turntie library that allows tying two TURN allocations with Mobility extension enabled together, for endpoints to be moved elsewhere and used for communicatinon.

Features

Limitations

Installation

Download a pre-built executable from Github releases or install from source code with cargo install --path crates/turntie-cli or cargo install turntie-cli.

Example

``` hostA$ turntie tie 203.0.113.65:3478 myuser mypassword eJwtj?REDACTED?kvUYOw== eJwtj?REDACTED?xjF6Y=

hostB$ turntie connect eJwtj?REDACTED?kvUYOw==

12345 < QQQQQ ^C

hostC$ turntie connect eJwtj?REDACTED?xjF6Y= < 12345

QQQQQ ^C ```

Both turntie connects should be running simultanesouly to work.

Full unredacted specifiers are typically consist of about 150 base64 characters.

CLI options

turntie --help output

``` Usage: turntie []

Use TURN server as a communication channel with movable ends Top-level command.

Options: --help display usage information

Commands: tie Create two allocation and return two specifier lines for their resumption connect Connect to one of the lines

Usage: turntie tie

Create two tied allocations and print two specifier lines for usage with 'turntie connect'.

Positional Arguments: turn_server address of TURN server to create allocations in username username to authenticate on TURN server with password password to authenticate on TURN server with

Options: --help display usage information

Usage: turntie connect

Connect to one of the endpoints created by 'turntie tie' and exchange stdin/stdout lines with the peer which connected to the other endpoint.

Positional Arguments: specifier serialized data describing the channel end

Options: --help display usage information

```