Installation#

Installing ttt is straight-foward:

pipx install ttt

Optionally:

  • If you want video, you will need to install ffmpeg1 on your system.
  • And if you want some audio with your video, you'll need portaudio2, and install pipx install ttt[audio] instead of the command above.

You should now be able to use the ttt command, but probably won't be able to see any output!

To fix that, you'll need to install a compatible font. Then, to correctly render the output, you'll need to set up your terminal emulator.

Compatible fonts#

Any font that's monospace and implements the Symbols for Legacy Computing Supplement Unicode block should be compatible.

However, as of writing, only two fonts (!) implement this Unicode block:

  • Iosevka: huge unicode coverage, extremely customizable, ligatures support, my favorite monospace font!
  ๐œบ โ–‚๐œถณ๐œถฏ๐œถฏ๐œบ                                                                                                                        
  ๐œถ–๐œตง๐œดช๐œดฐ๐œถท๐œท˜๐œตŒโ–– Check out my custom Iosevka variant, Iosevka Kotan.
  ๐Ÿฏง๐œดต๐œดช๐œดช๐œดช๐œดŸ๐œด  (It's the font you're reading right now!)                                                                           
    ๐œถ–๐œถ“๐œตˆ
  • Cascadia Code: made by Microsoft, bundled with Windows Terminal, seems pretty decent.
๐œต‘๐œต—๐œดช๐œดช๐œดช๐œดช๐œถ‰๐œถ€  Note: If you don't like either those fonts, that's fine!
๐œต‰๐œทฅโ–ˆ๐œตŠ๐œถ˜โ–ˆ๐œทค๐œถ—  You don't need to actually use them as your terminal font, but 
๐œด๐œต ๐Ÿฎ…๐œดฎ๐œดฒ๐Ÿฎ…๐œถ๐œด’  you can still install one of them so that your OS can use it as
 ๐œบซ๐Ÿฎ‚๐œท๐œท๐Ÿฎ‚๐œบจ   a fallback font, only for the required missing Unicode blocks.

Setting up your terminal emulator#

To correctly display ttt's outputs to the screen:

  • Make sure the character width and line height are set to defaults (in iTerm, the v|i and n|n settings should be set to 100).
   ๐œต‘๐œต—๐œดช๐œดช๐œดช๐œดช๐œถ‰๐œถ€  Note: If using a font other than the ones listed above,
   ๐œต‰๐œทฅโ–ˆ๐œตŠ๐œถ˜โ–ˆ๐œทค๐œถ—  try to adapt those two settings to match the aspect ratio of                                  
   ๐œด๐œต ๐Ÿฎ…๐œดฎ๐œดฒ๐Ÿฎ…๐œถ๐œด’  the fallback font you installed. For Iosevka, the native ratio                                
    ๐œบซ๐Ÿฎ‚๐œท๐œท๐Ÿฎ‚๐œบจ   of its block characters is exactly 16:40, and Cascadia 18:40.
  • If using Iosevka, use the "Iosevka Term" variant, which is narrower.

  1. On macOS: brew install ffmpeg.
    On Ubuntu: apt-get install ffmpeg.
    On Windows: ยฏ\_(ใƒ„)_/ยฏ ↩

  2. On macOS: brew install portaudio.
    On Ubuntu: apt-get install portaudio19-dev python3-all-dev.
    On Windows, the binaries are bundled with pyaudio. ↩