TRBot

TRBot is software that lets you play games through text. It also features Twitch support, allowing you to easily set up your own Twitch Plays stream!

Rundown

Play games through text with ease via inputs.

Delay and hold inputs, and specify precise durations down to the millisecond.

Add macros to store and play back input sequences.

Control multiple players!

Full feature list

•  Simple yet expressive input syntax - translate your text to game inputs easily. Make your inputs as simple or precise as you want!
• Portable and game-agnostic - just download (or build) and run! TRBot runs alongside your game and thus has great compatibility with numerous titles.
• Cross-platform - Runs on Windows (vJoy) and GNU/Linux (uinput).
• Highly performant input handling with extremely accurate inputs. Play with precision and consistency.
• Virtual gamepads - Use analog inputs for precision and set custom button mappings in games to play how you prefer.
• Run locally, through Twitch, a WebSocket of choice, an IRC channel, and even an XMPP multi-user chat room, all at the same time!
• Emulator support - NES, SNES, N64, GCN, and more. Several emulator controller config files are available.
• Multiplayer support - Control multiple players separately or simultaneously.
•  Sleep and reset prevention - forbid players from resetting the game, or prevent games/consoles from sleeping with a periodic input and interval of your choosing.
• Flexible "console" infrastructure - change inputs, add new inputs, or even add a new console with a different set of buttons, all on the fly.
•  Collaborative play quality-of-life enhancements - macros, game logs, user silencing (without timeout/ban), stop all ongoing inputs, and switch consoles readily.
• Commands - Interact with and manipulate TRBot through commands entered as text. Add your own commands and your own routines to extend TRBot's capabilities, even while it's running!
• SQLite database to manage access levels, commands, virtual controllers, and more. Most data changes are immediately reflected in TRBot.
• Moderation features - control access to commands, inputs, and other features independent of platform.
• Additional goodies and games - duel for credits, create memes, calculate expressions, and talk to a chatbot.

Setup/Configuration

•  Local - For releases 2.2.1 and beyond, download the separate source code archive, which contains the wiki. All documentation is in the Wiki folder. The getting started document is Setup-Init.md. Feel free to read the other documentation in the wiki for answers to your questions.
  • For 2.2 and below, source code and documentation is included with the binary releases.
• Online - You can also find the documentation in our code repository here.

If you are upgrading to TRBot 2.0+ from TRBot 1.8, please download and run the migration tool from a previous 2.0+ release on the repository. Be sure to make backups of your data and read through the Migrating-Data.md document before running the tool.

License

Code repository: https://codeberg.org/kimimaru/TRBot

Disclaimer: The game shown in the GIFs is not my creation. All rights of Super Mario Bros. 3 belong to Nintendo.

Copyright © 2019-2022 Thomas "Kimimaru" Deeb

All donations are greatly appreciated and go towards improving TRBot. Thank you very much for your support!

TRBot is free software; you are free to run, study, modify, and redistribute it. Specifically, you can modify and/or redistribute TRBot under the terms of the GNU Affero General Public License v3.0.

In simple terms, if you give someone a copy of TRBot or deploy TRBot to an online service, you must provide a way to obtain the license and source code for that version of TRBot upon request. This includes modified versions of TRBot.

Please see the included src/LICENSE file for the full terms and the src/Dependency Licenses file for the licenses of third party libraries used by TRBot.

TRBot's logo was designed by the talented David Revoy, well-known for his Pepper & Carrot comic series and is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Support

Find a bug with TRBot? Have an idea for a new feature? Or maybe you'd like to contribute but don't know how? Feel free to file an issue in our repository. Additionally, don't hesitate to ask in the comments below.

We are also on Matrix at #TRBot-Dev:matrix.org - come join us to discuss anything related to TRBot and collaborative play!