Skip to content

Commit a6fe141

Browse files
committed
Update README.md
1 parent b44e80a commit a6fe141

File tree

1 file changed

+60
-1
lines changed

1 file changed

+60
-1
lines changed

README.md

+60-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,60 @@
1-
# interspecies-reviewer
1+
# Interspecies Reviewer
2+
[![forthebadge made-with-rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=rust&logoColor=white)](https://www.rust-lang.org/)
3+
4+
![Build Status](https://github.com/guilamb/interspecies_reviewer/actions/workflows/build.yaml/badge.svg?branch=main)
5+
![Deploy Status](https://github.com/guilamb/interspecies_reviewer/actions/workflows/deploy.yaml/badge.svg?branch=main)
6+
![Security Status](https://github.com/guilamb/interspecies_reviewer/actions/workflows/gitgardian.yaml/badge.svg?branch=main)
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

Comments
 (0)