ToxBot

ToxBot is a remotely controlled Tox bot whose purpose is to auto-invite friends to Tox groupchats. It accepts friend requests automatically and will auto-invite friends to the specified group chat (default is group 0 unless set otherwise). It also has the ability to create and leave groups, password protect invites, and send messages to groups.

Although current functionality is barebones, it will be easy to expand the bot to act in more comprehensive ways once Tox group chats are fully implemented (e.g. admin duties); this was the main motivation behind creating a proper Tox bot.

Controlling

In order to control the bot you must add your Tox ID to the masterkeys file. Once you add the bot as a friend, you can send it privileged commands as normal messages.

Non-privileged commands

• help - Print this message
• info - Print current status and list active group chats
• id - Print Tox ID
• invite - Request invite to default group chat
• invite <n> <pass> - Request invite to group chat n (with password if necessary)
• group <type> <pass> - Creates a new groupchat with type: text | audio (optional password)

Privileged commands

• default <n> - Sets default groupchat room to n
• gmessage <n> <msg> - Sends msg to groupchat n
• leave <n> - Makes the ToxBot leave groupchat n
• master <id> - Adds Tox ID to the masterkeys file
• name <name> - Sets name of the ToxBot
• passwd <n> <pass> - Sets password for groupchat n (leave pass blank for no password)
• purge <n> - Sets the number of days before an inactive friend is deleted
• status <s> - Sets status of the ToxBot (online, busy or away)
• statusmessage <msg> - Sets status message of the ToxBot
• title <n> <msg> - Sets title for groupchat n

Notes

• ToxBot will automatically accept a groupchat invite from a masterkey.
• Message strings must be enclosed in double quotes.

Dependencies

pkg-config libtoxcore libtoxav

Compiling

Run make

Note: If you get an error that says cannot open shared object file: No such file or directory, try running sudo ldconfig.