Powerful software for playing games through text, supporting remote connectivity through services such as Twitch.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Kimimaru 1fd3bba077 Merge branch 'develop' 3 weeks ago
Controller Configs Removed XDotoolControllerManager and XDotoolController 2 months ago
Logo Added promo logos and updated the wiki 11 months ago
Supplementary Added a simple example program to set up a WebSocket that interacts with TRBot 4 months ago
TRBot Adjusted the recommended periodic input time and changed the message sent when set below this value 3 weeks ago
Wiki Fixed improperly formatted text 3 weeks ago
.gitignore Added more files to .gitignore 5 months ago
.gitmodules Added LibreTranslate integration 6 months ago
Dependency Licenses Added LiveSplitOne integration and a new TRBot.Integrations project 8 months ago
LICENSE Added AGPL-3.0 License 2 years ago
README.md Updated documentation and README 3 weeks ago
build.bat Added build batch script and updated build instructions 5 months ago
build.sh Updated documentation regarding Twitch connection and PC games 5 months ago



TRBot is software that enables playing video games through text. In simple terms, if you type "a", the character in your game can jump.

The goal of TRBot is to lower the barrier of entry for text-based gameplay and provide avenues to improve the experience. TRBot contains a set of projects to facilitate text-based gameplay, some of which allow for setting up and managing community-oriented remote play, including Twitch Plays.

TRBot is inspired by the bot used on the TwitchPlays_Everything channel. The input syntax allows for great precision, making it well-suited for many types of games, whether it's an RPG or a 3D platformer. You can use TRBot for many purposes, including collaborative remote play and automating tedious tasks, such as mashing buttons or grinding levels in an RPG.

The core application, TRBot.Main, connects all the projects of TRBot together to form a fully functional bot with input handling, commands, and more. You can use it as-is or build your own application around the projects!

Documentation, setup, building from source, playing


  • 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 and run! TRBot runs alongside your game and thus has great compatibility with numerouss titles.
  • Cross-platform - Runs on Windows (vJoy) and GNU/Linux (uinput).
  • Virtual gamepads - Use analog inputs for precision and set custom button mappings in games to play how you prefer.
  • Run locally, through Twitch, or connect to a WebSocket of choice. TRBot is also set up for integrating other services.
  • 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.
  • Highly performant input handling with near frame-perfect inputs. Play with precision and consistency.
  • Flexible "console" infrastructure - change inputs, add new inputs, or even add a new console with a different set of inputs, 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.


The original parser was written in Python by Jdog of TwitchPlays_Everything, which greatly helped jump-start TRBot's development.

TRBot's logo was designed by the talented David Revoy, well-known for his Pepper & Carrot comic series.


Copyright © 2019-2021 Thomas "Kimimaru" Deeb


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.

See the LICENSE file for the full terms. See the Dependency Licenses file for the licenses of third party libraries used by TRBot. See the logo license file for the license of TRBot's logo. Finally, see the documentation license file for the license of TRBot's documentation.

Attribution Banner

If you have found TRBot useful, please spread the word by placing one of our promo banners on your website, blog, video, or stream panel!

Link to large banner

  • Markdown code:
    ![Powered by TRBot](https://codeberg.org/kimimaru/TRBot/raw/branch/master/Logo/TRBotLogo_Promo.png "TRBot Logo")

Link to small banner

  • Markdown code:
    ![Powered by TRBot](https://codeberg.org/kimimaru/TRBot/raw/branch/master/Logo/TRBotLogo_Promo_Small.png "TRBot Logo")


Our main repository is on Codeberg: https://codeberg.org/kimimaru/TRBot.git

Issues and pull requests are greatly encouraged! Please file an issue if you encounter any bugs or have a feature request.


Feel free to ask questions or discuss development on our Matrix room at #TRBot-Dev:matrix.org. You can also [contact us](mailto:trbot (at) posteo (dot) de) for support. Paid setup and support options are also available.

Developing software takes considerable time and effort, and we have poured hundreds of hours of our spare time into making TRBot as powerful and feature-rich as it is and freely available to everyone. Kindly consider buying us a coffee or donating.