TinTin++ on iOS

Installing the TinTin++ Mud Client on iOS

See the install section for installation instructions for iOS / iPhone / iPad.


It's suggested to upgrade your iPhone's on screen keyboard to one that has access to the brace open/close, and other useful characters for a mud client.

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.

Mouse handling

The iSH terminal does not support mouse handling. There is a workaround available here: Running an SSH server on iSH. Once you get this working you'll need to install a mouse capable ssh client app in order to ssh into iSH.

Miscellaneous Tips and Tricks

  • The iSH Linux shell on iOS doesn't currently come with much documentation, it does have a discord subreddit channel for assistance.

  • Using TinTin++ on iSH is very similar to how you would use TinTin++ on Linux. iSH has a customizable keyboard enhancement that provides arrow keys, ctrl, esc, and tab by default.
  • 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 ctrl + 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.

  • It might be tricky to access your files from outside the iSH environment on your iPhone. 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 iSH
    10. Android: #chat call <ip address> 4050
    11. Windows: #chat sendfile iSH 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. #event {SCROLLED MOUSE WHEEL UP} #buffer up 1
    2. #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.