Powerful software for playing games through text, supporting remote collaborative play.
Go to file
Kimimaru 78d0e86a56
ci/woodpecker/push/main-application-build-linux-x64 Pipeline was successful Details
ci/woodpecker/push/main-application-build-win-x64 Pipeline was successful Details
ci/woodpecker/push/main-application-test-linux-x64 Pipeline was successful Details
ci/woodpecker/push/main-application-test-win-x64 Pipeline was successful Details
Merge branch 'develop'
2023-06-24 20:17:46 +03:00
.woodpecker Updated CI images to .NET 7 2023-04-08 11:36:01 +03:00
Controller Configs Added udev controller configs for RetroArch 2022-08-30 16:36:07 +03:00
Logo Added promo logos and updated the wiki 2020-12-21 23:04:31 -05:00
Submodules Updated documentation regarding connecting over Matrix 2023-06-11 21:39:02 +03:00
Supplementary Refactored events to include event IDs and consistent JSON names 2023-06-12 22:09:34 +03:00
TRBot Adjusted fallbacks as TRBot cannot be clean built without Git 2023-06-23 22:50:59 +03:00
Wiki Fixed grammar and typos 2023-06-24 19:52:30 +03:00
.gitignore Fixed failing to obtain build information on newly cloned repositories 2022-04-09 01:32:28 +03:00
.gitmodules Added Matrix-CS-SDK as a submodule 2023-06-08 20:57:22 +03:00
Dependency Licenses Updated documentation regarding connecting over Matrix 2023-06-11 21:39:02 +03:00
LICENSE Added AGPL-3.0 License 2020-01-04 21:02:53 +00:00
README.md Added 2.8.0 release notes 2023-06-24 19:42:06 +03:00
build.bat Added a system-wide install option 2022-02-20 20:38:11 +02:00
build.sh Added a system-wide install option 2022-02-20 20:38:11 +02:00


TRBot Logo

Donate using Liberapay Buy Me a Coffee at ko-fi.com

Play video games remotely and collaboratively through text

What is TRBot?

TRBot lets you play your favorite games collaboratively by typing inputs to control them.

Jumping into a painting in Super Mario 64 with TRBot

Simply put, if you type "a", the character in your game can jump. To enable collaborative play, TRBot reads inputs from online chat platforms, such as Twitch, IRC, XMPP, Matrix, and more. With TRBot, it's possible for hundreds of people to play the same game at the same time.

TRBot has a flexible "easy to learn, hard to master" format. Play as simple as you want then go for the gold with insane plays. Since its inception, TRBot has been used to play numerous games, and it has even helped discover brand new glitches in classic games!

Want to see more examples? Take a look!

Download the latest release


  • Play all types of games with friends or a community
  • Play your favorite games in a new way
  • Automation - create macros to grind in an RPG or mash buttons in a minigame
  • Accessibility - this quote by one user explains:
    I use it in two ways.
    1: To stream some twitch plays while I chat with chat. This often coincides with reason for
    2: I have chronic pain and can not play for long without breaks and am always in danger of damaging myself. This program let's chat or my friends play for me :D
  • And much more - feel free to share how you use TRBot!

For hosts

  • Portable - just download and run! TRBot has great compatibility with most titles since it runs alongside the game.
  • Accept messages through Twitch, Matrix, and other platforms like Discord at the same time!
  • Flexible - change inputs and buttons on the fly or add your own commands to extend TRBot's capabilities.
  • Moderation - control access to commands and inputs, and silence trolls independent of platform.
  • Sleep and reset prevention - Press a button automatically at regular intervals and restrict button combinations.
  • Emulator support - in-built consoles for SNES, PS2, GCN, and more. Several emulator controller config files are available.

For players

Streamers running TRBot

Documentation, setup, development

CI Status Develop



TRBot was created out of the joy of playing games collaboratively through text. Playing through text comes with its own challenges, yet it can be a very rewarding experience. For example, real-time combat in games may be nothing with a controller, but doing it through text is surprisingly difficult! Overcoming unique game challenges together is a core reason behind TRBot's existence.

TRBot was also inspired by the bot used on the TwitchPlays_Everything Twitch 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.


Feel free to ask questions or discuss development on our Matrix room at #TRBot-Dev:matrix.org. You can also contact us for support.

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, in both price and freedom. Kindly consider buying us a coffee or donating.


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-2023 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 versions of TRBot that you or someone else modified.

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 highly encouraged. Please file an issue if you encounter any bugs or have a feature request.