Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Recommend using Windows Terminal instead of mintty #405

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 7 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,19 +83,15 @@ Troubleshooting
`tmux_conf_theme_left_separator_XXX` values.

- **I'm using Bash On Windows (WSL), colors and Powerline look are broken.**

There is currently a [bug][1681] in the new console powering Bash On Windows
preventing text attributes (bold, underscore, ...) to combine properly with
colors. The workaround is to search your `~/.tmux.conf.local` copy and
replace attributes with `'none'`.

Also, until Window's console replaces its GDI based render with a DirectWrite
one, Powerline symbols will be broken.

The alternative is to use the [Mintty terminal for WSL][wsltty].

The Bash On Windows terminal that ships with WSL distros has problems
displaying certain text attributes and powerline code points. It's highly
recommended to use the [Windows Terminal][microsoft-terminal] application
instead (also installable from the [Microsoft Store][microsoft-store]).

[1681]: https://github.com/Microsoft/BashOnWindows/issues/1681
[wsltty]: https://github.com/mintty/wsltty
[microsoft-terminal]: https://github.com/microsoft/terminal
[microsoft-store]: https://aka.ms/terminal

Features
--------
Expand Down