You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Terminal output barely readable on light colour scheme. (ESPTOOL-1354) #1175
I insert a screenshot, because the issue is that on light colour scheme (black text, white background), the output of esptool is still coloured assuming a dark colour scheme, and so many things are barely readable:
Hi @dreirund! Please be aware that (1) the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems, (2) burning eFuses and enabling security features are irreversible operations and can damage your ESP32 device. We hope that this message will help you until an Espressif Engineer looks at your issue.
The knowledge sources do not contain enough information to provide a definitive answer or workaround specific to this issue (e.g., a --no-color flag or similar option for esptool v5).
That said, based on what the knowledge sources do describe about esptool v5's colored output:
The colored output was introduced in esptool v5 as a user experience improvement, designed with dark terminal themes in mind. [esptool v5 updates] The knowledge sources do not document any built-in flag to disable colors in esptool's CLI output.
Suggestions for the issue:
Check --help for a color-disable flag — Run esptool --help and look for any option like --no-color or --disable-color. The knowledge sources don't confirm such a flag exists, but it's worth checking directly in your version.
Environment variable — Many CLI tools respect NO_COLOR=1 (from the no-color.org convention) or TERM=dumb. You could try:
NO_COLOR=1 esptool --help
However, the knowledge sources do not confirm whether esptool v5 honors this convention.
File a feature request — If neither of the above works, this is a valid feature request: either auto-detecting terminal background color or providing a --no-color flag. The issue you've opened on GitHub is the right place for this.
I'd recommend checking the esptool GitHub repository directly or the project's changelog/documentation for any color-disabling options, as the knowledge sources available to me don't cover this specific configuration detail.
Hi @dreirund, as suggested by the bot, one way to get readable output is to use NO_COLOR=1 esptool --help. Seems like we are missing this information from the documentation. I will fix that.
Another option is to change the theme in the output with rich-click themes if you are using rich-click v1.9+. I would recommend that you find the best theme that suits your needs and use that globally. All our tools have (or soon will have) the same output.
Making the default output look good on any background is impossible. As most of the users have a dark background, we are using a theme that fits on dark.
NO_COLOR=1 disables colouring completely and, if I set it as default option globally, seems to affect many applications which have a colour scheme which is readable on both, dark and light, system-wide. So that is a dirty workaround only since it affects not only esptool.
So from that point of view, designing the colour scheme such that it is readable on both, dark and light, colour scheme, would be nice.
I found out so far that it is python-argparse probably doing it's this and that it is nothing you can easily control from your side?
Another option is to change the theme in the output with rich-click themes if you are using rich-click v1.9+.
Need to check this. Reads like another layer of complication, but maybe it is something which also works system-wide for some types of python libraries. If it works might be a solution.
Activity
github-actions commentedon Jul 5, 2026
Hi @dreirund! Please be aware that (1) the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems, (2) burning eFuses and enabling security features are irreversible operations and can damage your ESP32 device. We hope that this message will help you until an Espressif Engineer looks at your issue.
The knowledge sources do not contain enough information to provide a definitive answer or workaround specific to this issue (e.g., a
--no-colorflag or similar option foresptoolv5).That said, based on what the knowledge sources do describe about
esptoolv5's colored output:The colored output was introduced in
esptoolv5 as a user experience improvement, designed with dark terminal themes in mind. [esptool v5 updates] The knowledge sources do not document any built-in flag to disable colors inesptool's CLI output.Suggestions for the issue:
Check
--helpfor a color-disable flag — Runesptool --helpand look for any option like--no-coloror--disable-color. The knowledge sources don't confirm such a flag exists, but it's worth checking directly in your version.Environment variable — Many CLI tools respect
NO_COLOR=1(from the no-color.org convention) orTERM=dumb. You could try:However, the knowledge sources do not confirm whether
esptoolv5 honors this convention.File a feature request — If neither of the above works, this is a valid feature request: either auto-detecting terminal background color or providing a
--no-colorflag. The issue you've opened on GitHub is the right place for this.I'd recommend checking the esptool GitHub repository directly or the project's changelog/documentation for any color-disabling options, as the knowledge sources available to me don't cover this specific configuration detail.
[-]Terminal output barely readable on light colour scheme.[/-][+]Terminal output barely readable on light colour scheme. (ESPTOOL-1354)[/+]peterdragun commentedon Jul 7, 2026
Hi @dreirund, as suggested by the bot, one way to get readable output is to use
NO_COLOR=1 esptool --help. Seems like we are missing this information from the documentation. I will fix that.Another option is to change the theme in the output with rich-click themes if you are using rich-click v1.9+. I would recommend that you find the best theme that suits your needs and use that globally. All our tools have (or soon will have) the same output.
Making the default output look good on any background is impossible. As most of the users have a dark background, we are using a theme that fits on dark.
dreirund commentedon Jul 9, 2026
NO_COLOR=1disables colouring completely and, if I set it as default option globally, seems to affect many applications which have a colour scheme which is readable on both, dark and light, system-wide. So that is a dirty workaround only since it affects not onlyesptool.So from that point of view, designing the colour scheme such that it is readable on both, dark and light, colour scheme, would be nice.
I found out so far that it is
python-argparseprobably doing it's this and that it is nothing you can easily control from your side?Need to check this. Reads like another layer of complication, but maybe it is something which also works system-wide for some types of python libraries. If it works might be a solution.
Thanks!
docs: Add documentation for color output and CLI help themes