Skip to content

Terminal output barely readable on light colour scheme. (ESPTOOL-1354) #1175

Closed as not planned

Description

@dreirund

Operating System

Artix GNU/Linux (rolling release)

Esptool Version

v5.3.0

Python Version

3.14.5

Full Esptool Command Line that Was Run

esptool --help

Esptool Output

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:


Image

What is the Expected Behaviour?

  • Colour scheme based on terminal, or
  • no colouring by default.

Regards!

Activity

  1. github-actions commented on Jul 5, 2026

    @github-actions

    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:

    1. 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.

    2. 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.

    3. 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.

  2. changed the title [-]Terminal output barely readable on light colour scheme.[/-] [+]Terminal output barely readable on light colour scheme. (ESPTOOL-1354)[/+] on Jul 5, 2026
  3. peterdragun commented on Jul 7, 2026

    @peterdragun
    Collaborator

    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.

  4. dreirund commented on Jul 9, 2026

    @dreirund
    Author

    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.

    Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions