TinTin++ on Android

Installing the TinTin++ Mud Client on Android

  • Install Termux (an Android terminal emulator and Linux environment) using the Termux website (the Google play store version might be outdated), next launch Termux and enter:
  • apt update
  • apt install tintin++
  • tt++

Hackers Keyboard

It's suggested to upgrade your phone's on screen keyboard to one that has access to the arrow keys, brace open/close, and other useful characters for a mud client. One such keyboard is Hacker's Keyboard which is available at the Google play store.

Data Access

It is necessary to grant storage permission for Termux on Android 6 and higher. Use 'Settings>Apps>Termux>Permissions>Storage' and set to true.
Next return to the Termux terminal and execute 'termux-setup-storage'. What this command does is described in detail at termux-setup-storage wiki page.
For ease of access you can create a symbolic link in your Termux home directory to Android's internal storage using 'ln -s storage/shared/Android/data/com.termux/files' which should be accessible when you connect your phone to a computer.


If you're new to Linux and need a simple text editor it's suggested to use 'nano -m <filename>'. The -m enables mouse mode, which makes editing fairly straight forward.

Input bar

A useful thing to have is an input bar. You can create one on TinTin++ by using: #split. See #help split for more information. This will prevent the prompt from overwriting what you are typing.

Background process

If TinTin++ is behaving oddly when switching Termux to another app and returning back to it, like losing your connection, make sure to allow Termux to run while in the background. This setting is typically located in the Apps section.

Miscellaneous Tips and Tricks

  • Make sure to read the Termux helpfile on using a touch keyboard for information about control codes. In order to enable autocompletion you need to swipe the CTRL ALT bar at the top of the keyboard to the left. To return to native input editing tap anywhere on the main screen.

  • Using TinTin++ on Termux is very similar to how you would use TinTin++ on Linux. The main difference is that if you're using a touch screen you can simulate pressing the control key by pressing the volume down button. To move north when pressing volume-down + n you would type: #macro \cn north. To have TinTin++ record a keypress you would press volume-down + v followed by the keypress you want to record. For example: volume-down + v followed by volume-up + 1. Keep in mind that Termux pre-defines several volume-up keyboard shortcuts which cannot be captured by TinTin++.

  • If you need more than 26 macros it's possible to create more complex macros. For example #macro {\con} {open north}, #macro {\cos} {open south}, etc. You would then press volume-down + o followed by the letter n to execute 'open north'. Using this approach it's possible to set hundreds of macros that require two keypresses.

  • If you are running TinTin++ v2.01.91 or higher you can also try #macro {^nn} {n} which will make tintin execute 'n' if you double tap n at the start of a line.

  • Termux provides brief but informative documentation on topics like key bindings and external storage. Termux also provides an API so you can have TinTin++ vibrate the phone, read and send SMS messages, create text to speech messages, and a few other cool things.

  • The process of accessing Termux files from outside the Termux environment can be tricky. One workaround is to transfer files using tintin's built-in chat client. In this example we'll assume access to a Windows PC.

    1. Install WinTin++ and use the start menu shortcut to visit the WinTin++ directory and copy any files you want to transfer to the bin directory.
    2. Configure WinTin++ to your liking and use #write main.tin to save the settings, next issue the following commands:
    3. Windows: #chat init
    4. Windows: #chat name Windows
    5. You might get a pop-up message from your firewall asking if it's alright for the program to open a socket, click yes.
    6. Next open the windows command shell (press windows-r, next type cmd) and enter: ipconfig
    7. This should show you something like: IPv4 Address . . . ., you need the specific address for your pc, which should start with 192.168. Now issue the following commands:
    8. Android: #chat init
    9. Android: #chat name Termux
    10. Android: #chat call <ip address> 4050
    11. Windows: #chat sendfile Termux main.tin
    12. Android: #chat accept

  • As of TinTin++ version 2.01.8 it's possible to move around using the touch screen in combination with the TinTin++ automapper. Check the specifics on the automapper in the manual. The following commands should set up basic touch screen mapping.

    1. #split 7 1
    2. #map create
    3. #map flag vtmap on
    4. #map flag unicode on
    5. #config mouse on
    6. #event {MAP SHORT-CLICKED MOUSE BUTTON ONE} #map run %0

    After setting these configurations and defining the event you should be able to click on a room and automatically run to it.

  • As of TinTin++ version 2.01.91 it's possible to add swipe scrolling as following.

    1. #config mouse on
    2. #event {SCROLLED MOUSE WHEEL UP} #buffer up 1
    3. #event {SCROLLED MOUSE WHEEL DOWN} #buffer down 1

  • As of TinTin++ version 2.02.40 there is the #config hibernate option which will make tintin poll less aggressively for input and output. This lowers the CPU usage and can be useful to increase battery life.