Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


rustybot is a Tox groupchat trivia bot written in Rust.


rustybot is capable of playing multiple games at once in any number of groups. Player statistics including total points accumulated, rounds won, and games won, are stored in a database and persist across restarts. Tox ID's are used as database keys, which means peers will always be tied to the same entry as long as their Tox ID doesn't change.

She reads questions from the data/questions file which will need to be provided by the owner. Questions and answers must be divided by the ` character and each line must end in a \n byte. An example list can be found here.

Usage and ownership

rustybot automatically accepts friend requests and group invites. The person who invites her to the group becomes her owner for that group and may use privileged commands. Additionally, all Tox ID's contained in the data/masterkeys file are her permanent owners and may use privileged commands in any group.

Non-privileged commands

  • !help - Print a list of non-privileged commands
  • !hint - Display a hint for the current question
  • !source - Link to the source code
  • !score - Print your score
  • !stats - Print the leaderboard
  • !trivia - Begin a game of trivia

Privileged commands

  • !quit - Leave the groupchat
  • !stop - End the current trivia game
  • !disable - Disables the trivia command
  • !enable - Enables the trivia command

Compiling and running

cargo build && cargo run or just cargo run


No releases published


No packages published