README.md

Posh-My-CMD

Description

Make your CMD prompt look better with colors, powerline characters, environment variables, and more.

Versions

There are two versions of this application, the Basic-CMD-Poshifier.py version and the Posh-My-CMD.py version. Both can be found in the Program folder of this repository. The Basic-CMD-Poshifier is the original version, it has a harder to visualize syntax for making prompts but most of the time is faster to use when making new prompts. The Posh-My-CMD version has an easier to understand syntax for prompt making but will probably take more time to make a new prompt. Enter -help in either of the running programs' Python terminals to display their help message.

Resources

• For info on the Windows API and it's escape sequences for terminals:

  https://learn.microsoft.com/en-us/windows/console/console-virtual-terminal-sequences

• A Github page on ANSI escape codes and how they work:

  https://gist.github.com/fnky/458719343aabd01cfb17a3a4f7296797

• For a long list of different ANSI control functions and what they do:

  https://vt100.net/docs/vt510-rm/chapter4.html

• For the syntax and help on the CMD prompt command:

  https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/cc725943(v=ws.11)?redirectedfrom=MSDN

• For the syntax and help on the CMD color command:

  https://ss64.com/nt/color.html

• For help on setting environment variables with CMD:

  https://www.opentechguides.com/how-to/article/windows-10/113/windows-10-set-path.html

• For more info on escape characters/sequences, delimiters, and using quotes in CMD/batch files:

  https://ss64.com/nt/syntax-esc.html

• The Wikipedia page for control characters:

  https://en.wikipedia.org/wiki/Control_character

• The Wikipedia page for ANSI escape codes:

  https://en.wikipedia.org/wiki/ANSI_escape_code#Colors

• The Colorama Python module's Github, which is used for displaying basic formatted text to terminals across OSs:

  https://github.com/tartley/colorama/tree/master/colorama

• To download/generate a nerd font at the official nerd font website:

  https://www.nerdfonts.com/

• For the Colortool Github, which is for changing and viewing the current palette in terminals like CMD and PWSH:

  https://github.com/microsoft/terminal/tree/main/src/tools/ColorTool

• To generate Colortool complatible (.itermcolors, .ini) color scheme files:

  https://terminal.sexy/

• For the official Oh-My-Posh website, used for making the prompt better/customizing the prompt in terminals:

  https://ohmyposh.dev/

• For the Oh-My-Posh Github website:

  https://github.com/JanDeDobbeleer/oh-my-posh

• For a tutorial on basic personalization of your CMD terminal:

  https://www.howtogeek.com/16815/how-to-personalize-the-windows-command-prompt/

• DEC box drawing character table:

  https://vt100.net/docs/vt220-rm/ma-0893c-83-special.svg

License

This project is available under the MIT License, for more information reference the LICENSE.txt file.