Telecord

Telecord is a bot that translates Discord messages to Telegram Messages (and the other way around).

Documentation Crates.io

Current Status

it works

Getting the bot

From binary release

Grab a download from the current release. If there is no release for your operating system or architecture, go to the Crates.io or From Source sections of this readme.

From Crates.io

This project requires Rust Nightly to compile. If you don't have Rustup, this is where you install it.

The following command will download the latest stable version of Telecord from crates.io, compile it, and install the binary to ~/.cargo/bin/telecord bash rustup run nightly cargo install telecord

From source

This project requires Rust Nightly to compile. If you don't have Rustup, this is where you install it.

```bash git clone https://github.com/asonix/telecord.git

rustup install nightly rustup run nightly cargo build --release `` This will create a binary in./target/releasethat you can run with./target/release/telecord`, or you can copy it wherever you need.

Usage

Make sure you have the proper environment variables set. You can do this with export or by modifying the .env file. A sample .env is provided in this crate as .env.sample

DISCORD_BOT_TOKEN and TELEGRAM_BOT_TOKEN are self-explanatory, but CHAT_MAPPINGS is a comma separated list of colon-separated tuples. The environment variable 1234:abcd,5678:efgh maps telegram chat 1234 to discord channel abcd, and also maps telegram chat 5678 to discord channel efgh.

Once you have your environment variable set, you can use ./path/to/your/telecord/binary to run the bot. Please note that the bot must be added to and be able to read messages in the Discord Channels and Telegram Chats it is meant to connect.

Running the program inline

bash TELEGRAM_BOT_TOKEN="your token" \ DISCORD_BOT_TOKEN="your token" \ CHAT_MAPPINGS="your mappings" \ RUST_LOG=telecord=info \ ./path/to/your/telecord/binary

As a SystemD process

Make sure you have a user and group you wish to run the bot as. If you don't, you can run it as your own user, or create a new user and group. ``` [Unit] Description=A bot to connect Telegram to Discord After=network.target

[Service] Type=simple User=your-telecord-user Group=your-telecord-group Environment="TELEGRAMBOTTOKEN=YOURBOTTOKEN" Environment="DISCORDBOTTOKEN=YOURBOTTOKEN" Environment="CHATMAPPINGS=CHATONE:CHANNELONE,CHATTWO:CHANNELTWO" Environment="RUSTLOG=telecord=info" ExecStart=/path/to/your/telecord/binary TimeoutSec=90 Restart=always

[Install] WantedBy=default.target ```

On Windows

With Powershell and the -msvc release

In powershell, navigate to the folder that contains the .exe file and run the following commands powershell $env:RUST_LOG = "telecord=info" $env:TELEGRAM_BOT_TOKEN = "YOUR_TELEGRAM_TOKEN" $env:DISCORD_BOT_TOKEN = "YOUR_DISCORD_TOKEN" $env:CHAT_MAPPINGS = "chat_one:channel_one,chat_two:channel_two" .\telecord.exe

With MingW and the -gnu release

In bash, navigate to the folder that contains the .exe file and run the following comands bash TELEGRAM_BOT_TOKEN="your token" \ DISCORD_BOT_TOKEN="your token" \ CHAT_MAPPINGS="your mappings" \ RUST_LOG=telecord=info \ ./telecord.exe

License

Telecord is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Telecord is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. This file is part of Telecord

You should have received a copy of the GNU General Public License along with Telecord If not, see http://www.gnu.org/licenses/.