|
1 |
| -# interspecies-reviewer |
| 1 | +# Interspecies Reviewer |
| 2 | +[](https://www.rust-lang.org/) |
| 3 | + |
| 4 | + |
| 5 | + |
| 6 | + |
| 7 | + |
| 8 | +Interspecies Reviewer is a Discord bot written in Rust. The primary purpose of this bot is to automatically replace social network links with variants that fix the Discord embed issues. For example, it would changes `twitter.com` links to `fxtwitter.com` to ensure proper embed rendering. |
| 9 | + |
| 10 | +## Project Goals |
| 11 | +The main goal of Interspecies Reviewer is to serve as a learning project for Rust. |
| 12 | +It' my first exploration into the Rust programming language. |
| 13 | + |
| 14 | +## Installation |
| 15 | + |
| 16 | +In order to get your Token, please follow this guide from discord. |
| 17 | +https://discord.com/developers/docs/getting-started |
| 18 | + |
| 19 | + |
| 20 | +### Raw |
| 21 | +To install Interspecies Reviewer, simply compile the source code using `rustc` and launch the binary generated by `rustc`. |
| 22 | + |
| 23 | +Ensure you set your Discord bot token as an environment variable `DISCORD_TOKEN`, or directly set the token value in the code. |
| 24 | +```bash |
| 25 | +# Example installation steps |
| 26 | +$ rustc main.rs |
| 27 | +$ ./main |
| 28 | +``` |
| 29 | + |
| 30 | +### Docker |
| 31 | +Alternatively, you can use Docker for installation. Pull the latest image: |
| 32 | + |
| 33 | +```bash |
| 34 | +docker pull ghcr.io/guilamb/interspecies_reviewer:dev-latest |
| 35 | +``` |
| 36 | + |
| 37 | +Then, run the image with your Discord token: |
| 38 | +```bash |
| 39 | +docker run -e DISCORD_TOKEN="MySecretToken" ghcr.io/guilamb/interspecies_reviewer:dev-latest |
| 40 | +``` |
| 41 | + |
| 42 | + |
| 43 | + |
| 44 | +## Usage |
| 45 | +Add the bot to your Discord server. |
| 46 | +The bot will automatically replace applicable social network links in messages. |
| 47 | +https://discord.com/developers/docs/getting-started |
| 48 | +## Configuration |
| 49 | +The only configuration setting for Interspecies Reviewer is the Discord Token. Ensure you set it up appropriately for the bot to function correctly. |
| 50 | +⚠️ If you inadvertently leak your token on Discord, it will be automatically invalidated. |
| 51 | + |
| 52 | +## Dependencies |
| 53 | +Interspecies Reviewer relies on the [Serenity](https://crates.io/crates/serenity) library as its main dependency. |
| 54 | + |
| 55 | + |
| 56 | +## Contributing |
| 57 | +Contributions to Interspecies Reviewer are welcome! If you encounter issues or have suggestions, please open an issue. Code examples and pull requests are also appreciated. |
| 58 | + |
| 59 | +## License |
| 60 | +GPL |
0 commit comments