Skip to content

Latest commit

 

History

History
44 lines (31 loc) · 2.06 KB

why-looks-bad-on-macos.question.md

File metadata and controls

44 lines (31 loc) · 2.06 KB
title alt_titles
Why doesn't Textual look good on macOS?
looks bad on macOS
dashed lines on macOS
broken borders on macOS
pale colors on macOS
pale colours on macOS
mac terminal
macOS terminal

You may find that the default macOS Terminal.app doesn't render Textual apps (and likely other TUIs) very well, particuarily when it comes to box characters. For instance, you may find it displays misaligned blocks and lines like this:

Screenshot 2023-06-19 at 10 43 02

You can (mostly) fix this by opening settings -> profiles > Text tab, and changing the font settings. We have found that Menlo Regular font, with a character spacing of 1 and line spacing of 0.805 produces reasonable results. If you want to use another font, you may have to tweak the line spacing until you get good results.

Screenshot 2023-06-19 at 10 44 00

With these changes, Textual apps render more as intended:

Screenshot 2023-06-19 at 10 43 23

Even with this fix, Terminal.app has a few limitations. It is limited to 256 colors, and can be a little slow compared to more modern alternatives. Fortunately there are a number of free terminal emulators for macOS which produces high quality results.

We recommend any of the following terminals:

Terminal.app colors

Screenshot 2023-06-19 at 11 00 12

iTerm2 colors

Screenshot 2023-06-19 at 11 00 25