terminal_style_toolkit

Scripts / tools / config for terminal styling and colors / colours

terminal_style_toolkit

Table of contents generated with markdown-toc

Notes

When testing out a color scheme/theme consider different use cases:

pyshow_colors2.py
- with ls_colors_test.txt
ls colors (LSCOLORS, LS_COLORS, dircolors and .dir_colors)
- https://github.com/dracula/putty/issues/3
- ls_colors_test.txt
- https://github.com/joshjon/bliss-dircolors - good starting point
neofetch
vim colorscheme

In general avoid:

Solutions that modify the TERM variable in .bashrc.
Solutions that modify the Vim t_Co variable.

Fonts Notes

Under Linux, Bitstream Vera Sans Mono is typically built-in and not bad
Under Windows, the built-in Consolas is not bad (better than Courier New, that Putty defaults to), available since Microsoft Windows Vista. A similar (free) font is Inconsolata / InconsolataGo (Inconsolata with straight quotes)
Many fonts at https://www.nerdfonts.com/ - worth checking out:
- EnvyCodeR
- FiraMono - https://mozilla.github.io/Fira/
- Go-Mono
- InconsolataGo https://github.com/im-AMS/Inconsolata-Nerd-Font-with-ligatures
- Overpass
- UbuntuMono
Fantasque Sans Mono - https://github.com/belluzj/fantasque-sans
Iosevka
- http://be5invis.github.io/Iosevka
- https://github.com/be5invis/Iosevka
- https://typeof.net/Iosevka/

Sample files

sample_text_editor.txt utf-8 text file to test view/edit of fixed width fonts. Not suitable for in depth syntax highlighting tests.
Short code samples for different languages are available in https://github.com/clach04/Dracula_cursor/tree/main/dev/sample clone/mirror of https://github.com/dracula/cursor/tree/main/dev/sample
https://github.com/altercation/solarized/tree/master/utils/tests has a collection of (small) different source code file types for testing syntax highlighting.
https://github.com/darekkay/config-files/tree/master/color-schemes/example-files

Scripts for running in terminal

truecolor.awk modified from https://github.com/sonph/dotfiles/blob/master/bin/truecolor.sh - truecolor test
invaders.bash from https://paste.xinu.at/m-dAiJ/
show_colors.bash from https://bbs.archlinux.org/viewtopic.php?id=51818&p=1%29
- Unknown license, many different versions of this script online
show_colors2.bash my version derived from show_colors.bash
color-test.bash - derived from https://gilesorr.com/bashprompt/howto/c333.html - shows all foreground colors as text with default background as a sanity check
pyshow_colors2.py in-progress Python version of show_colors2.bash
colors.py from https://gist.github.com/lilydjwg/fdeaf79e921c2f413f44b6f613f6ad53
parse_palette_tools.py - tools for dumping palettes for easier read/conversion

Conversion tools

putty/any2theme.py - Convert many input theme formats and render with any template (or output raw tstk json). Input files supported; tstk json, Alacritty TOML, iTerm2, Putty reg, pywal16
parse_palette_tools.py - tools for dumping palettes for easier read/conversion
alacritty_yaml2toml.py - rough convert alacritty YAML into alacritty TOML
goghjson2puttyjson.py - tools for converting Gogh JSON Color Schemes from https://github.com/Gogh-Co/Gogh/ into json that Putty conversion tools (json2putty_reg.py) can use. Use output with python putty\any2theme.py --output_extension .tstk -t terminal_style_toolkit_json.mustache -i tstk ...
pywaltemplate2puttymustache.py - convert pywal16 template
putty/json2putty_reg.py - convert (Putty) json into Putty registry import and html preview - Used to create https://github.com/clach04/putty_themes
Also see https://github.com/clach04/themer

any2theme

Examples:

python putty/any2theme.py --help

# generate Putty registry export
py -3 any2theme.py some_theme.tstk --output_extension .reg
python putty/any2theme.py  C:\code\terminal\putty_themes\raw_themes\dracula.tstk --output_extension .reg


# generate Terminal Style Toolkit json tstk file
py -3 any2theme.py some_theme.tstk --output_extension .tstk -t terminal_style_toolkit_json.mustache
# From putty registry export
py -3 any2theme.py --output_extension .tstk -t terminal_style_toolkit_json.mustache some_theme.reg
# From alacritty TOML export
py -3 any2theme.py --output_extension .tstk -t terminal_style_toolkit_json.mustache some_theme.toml

# Generate Microsoft ColorTool INI output
py -3 any2theme.py some_theme.tstk --output_extension .ini -t ms_colortool_ini.mustache

# generate Base24 theme
py -3 any2theme.py some_theme.tstk --output_extension .yaml -t base24_scheme.mustache

TODO support alacritty.toml like (see existing issue for similar support for tstk):

[colors.cursor]
text = "CellBackground"

Misc tools

color_mapper.html - Local web browser parser/mapper that can generate tstk json files. Try it out by copy/pasting the table from https://github.com/srcery-colors/srcery-palette
mintty_screenshot.py - launch mintty with specific theme and run pyshow_colors2 and then take a screenshot To setup: pip install -r requirements_optional.txt Screenshots are in BMP format, strongly recommend converting to PNG for size/space reasons.

Putty

See Putty tools readme and also https://github.com/clach04/putty_themes/

python_windows_registry_putty_colors.py - dumps session names and colors (only) along with simple show sessions that use the exact same same-color scheme feature
Sane Putty settings https://web.archive.org/web/20191231204120/http://dag.wiee.rs/blog/content/improving-putty-settings-on-windows lots of good tips, identifies the problem with the out of box blue color in Putty, recommends:
- ANSI Blue; Red: 74 Green: 74 Blue:255
- ANSI Blue Bold; Red:140 Green:140 Blue:255
https://www.thegeekstuff.com/2009/07/10-practical-putty-tips-and-tricks-you-probably-didnt-know/

Microsoft Windows CMD.exe

See colors https://github.com/microsoft/terminal/blob/71c75561e5df3db53cfe6f9da1173a46441b99ed/src/tools/ansi-color/ansi-color.cmd https://github.com/microsoft/terminal/blob/main/src/tools/ansi-color/ansi-color.cmd for example:

ansi-color.cmd colortest.def

See Color Tool (ColorTool) https://github.com/microsoft/terminal/releases/tag/1904.29002 The campbell.ini color scheme is the Windows 10 Fall Creator’s Update CMD out-of-box colors if need to restore to original colors.

From https://github.com/microsoft/terminal/tree/1904.29002/tools/ColorTool readme:

cmd-legacy is the legacy color scheme of the Windows Console, before July 2017
campbell is the new default scheme used by the Windows Console Host, as of the Fall Creator’s Update.

NOTE latest ColorTool source is located in https://github.com/microsoft/terminal/tree/main/src/tools/ColorTool

ColorTool can use:

json format as used by concfg https://github.com/lukesampson/concfg
XML format as used by iTerm2-Color-Schemes - https://github.com/mbadolato/iTerm2-Color-Schemes/
INI format, as provided in samples for ColorTool https://github.com/microsoft/terminal/tree/main/src/tools/ColorTool

See ms_colortool_ini.mustache for generating ColorTool color themes.

Resources

Color Codes

ANSI colors are numbered:

black
red
green
yellow
blue
magenta
cyan
white

bright black
bright red
bright green
bright yellow
bright blue
bright magenta
bright cyan
bright white

https://en.wikipedia.org/wiki/ANSI_escape_code#3-bit_and_4-bit
https://jakob-bagterp.github.io/colorist-for-python/ansi-escape-codes/standard-16-colors/
https://hexdocs.pm/color_palette/color_table.html
https://github.com/termstandard/colors
https://stackoverflow.com/questions/4842424/list-of-ansi-color-escape-sequences/75985833#75985833 useful table of codes
https://github.com/Gbox4/ansicodes - interactive web page for generating ANSI escape codes
- https://github.com/clach04/ansicodes - clone with github pages https://clach04.github.io/ansicodes/

Mappings; ColorTool, Putty / tstk, and Base24 / Tinted Theming

ColorTool INI Key | Colour Variable | Base24 Variable
------------------+-----------------+-----------------
BACKGROUND        | Colour2         | base00
DARK_BLACK        | Colour6         | base00 / base01
BRIGHT_BLACK      | Colour7         | base03 / base02
FOREGROUND        | Colour0         | base05
DARK_WHITE        | Colour20        | base06
BRIGHT_WHITE      | Colour21        | base07
DARK_RED          | Colour8         | base08
BRIGHT_RED        | Colour9         | base12
DARK_YELLOW       | Colour12        | base0A
BRIGHT_YELLOW     | Colour13        | base13
DARK_GREEN        | Colour10        | base0B
BRIGHT_GREEN      | Colour11        | base14
DARK_CYAN         | Colour18        | base0C
BRIGHT_CYAN       | Colour19        | base15
DARK_BLUE         | Colour14        | base0D
BRIGHT_BLUE       | Colour15        | base16
DARK_MAGENTA      | Colour16        | base0E
BRIGHT_MAGENTA    | Colour17        | base17

Color Tools

http://colorlab.wickline.org/colorblind/colorlab/ - view colors in web browser and simulate color blindness
https://terminal.sexy/
https://it-tools.tech/color-converter
- https://github.com/CorentinTh/it-tools
https://iconscout.com/blog/best-color-palette-generators-for-any-design-project
https://colorffy.com/color-scheme-generator?color=257abb
https://github.com/clach04/themer
pastel A command-line tool to generate, analyze, convert and manipulate colors

vim

NOTE Windows vim for cmd does NOT support italics https://github.com/vim/vim/commit/ac8a10ab7672aa5fd359f76d34d8b0187728b92d

https://bytefluent.com/vivify/ A ColorScheme Editor for Vim
https://github.com/chrisbra/Colorizer vim plugin to visualize hex color codes
https://github.com/lifepillar/vim-colortemplate - handle 2 color to full color

vim themes that only use ANSI (16) colors - https://jeffkreeftmeijer.com/vim-16-color/

https://github.com/noahfrederick/vim-noctu
https://github.com/jeffkreeftmeijer/vim-dim/
https://github.com/dylanaraps/wal.vim - actually 8 colors
https://github.com/chriskempson/base16-vim/
NeoVim
- https://github.com/uZer/pywal16.nvim
- https://github.com/AlphaTechnolog/pywal.nvim
- https://github.com/sonjiku/yawnc.nvim

Midnight Commander

See https://github.com/jan-warchol/selenized/tree/putty/mc and https://github.com/jan-warchol/selenized/issues/7

MC’s default color settings assume that terminal’s blue will be very dark and suitable for use as background.

ls colors / dir_colors

https://www.systutorials.com/docs/linux/man/5-dir_colors/
https://github.com/joshjon/bliss-dircolors
https://github.com/seebi/dircolors-solarized
https://github.com/nordtheme/dircolors
https://github.com/clach04?submit=Search&q=dircolors&tab=stars&type=&sort=&direction=&submit=Search
https://github.com/dracula/putty/issues/3 - Unreadable colors/colors with a=rwx permission directory and ls in color mode - default dircolors conflicts with terminal colors
Suggestion from https://github.com/jan-warchol/selenized/tree/putty/dircolors related to https://github.com/jan-warchol/selenized/issues/1
```
# fix dircolors for Selenized
export LS_COLORS="$LS_COLORS:ow=1;7;34:st=30;44:su=30;41"
```
https://github.com/sharkdp/vivid A themeable LS_COLORS generator with a rich filetype datebase
https://github.com/trapd00r/LS_COLORS - nice selection of consistent colors flr filetypes

https://github.com/anonimoanemico/puttier
- Supports previewing a theme
https://github.com/mvelikikh/putty-session-manager

Non-Terminal

https://github.com/monolifed/scite_theme scite themes from base16 config
https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/tools
https://github.com/Gogh-Co/Gogh/tree/master/tools
Base-16/Base16 and derivatives
https://github.com/worron/ACYLS - Any Color You Like Simple icon pack
Windows Color Pickers
- http://instant-eyedropper.com/
  - https://github.com/miaupaw/instant-eyedropper
- http://www.nattyware.com/pixie.php
- https://colorcop.net/
  - https://github.com/ColorCop/ColorCop

TODO Resources

https://blog.codinghorror.com/code-colorizing-and-readability/ note, cites studies with CRTs, pre lcd.

To checkout:

https://github.com/fikovnik/bin-scripts/blob/master/color-test.sh
https://github.com/fikovnik/bin-scripts/blob/master/term-colors.py
https://github.com/mvelikikh/putty-session-manager
https://ciembor.github.io/4bit/ - could code from https://github.com/ciembor/4bit be used as a web viewer preview (compare with puttier)

Color schemes that pass eyeball test but I’d like to checkout:

https://github.com/mattly/iterm-colors-farmhouse - light and dark
https://github.com/mattly/iterm-colors-pencil - light and dark
https://github.com/kepano/flexoki - light and dark

Color Scheme Collections

iTerm2
- https://github.com/mbadolato/iTerm2-Color-Schemes - preview limited
  - https://iterm2colorschemes.com/
- https://github.com/wozozo/Hemisu-Light-iTerm2
https://github.com/Gogh-Co/Gogh - OK preview, can at least see palette block to easily compare colors
- https://gogh-co.github.io/Gogh/
- 16 color themes that have bright/bold versions of base colors
  - Aci
  - Argonaut
  - Azu
  - Bim
  - Birds Of Paradise
  - Blazer
  - Blue Dolphin
  - …
Alacritty
- https://github.com/embark-theme/alacritty
- https://github.com/rajasegar/alacritty-themes/ - no previews
  - https://github.com/rajasegar/alacritty-themes/blob/master/themes/IR-Black.toml
- https://github.com/alacritty/alacritty-theme - preview limited
  - citylights
  - Cobalt2 - https://github.com/alacritty/alacritty-theme/blob/master/themes/Cobalt2.toml
  - dark_pastels
  - dark_plus
  - doom_one
  - dracula
  - dracula_plus
  - enfocado_dark
  - enfocado_light
  - flexoki
  - github_dark_high_contrast
  - github_light
  - google
  - gnome_terminal
  - gruvbox_dark
  - gruvbox_light
  - kanagawa_dragon
  - kanagawa_wave
  - midnight-haze
  - monokai
  - monokai_charcoal
  - monokai_pro
  - moonlight_ii_vscode
  - nord
  - oceanic_next
  - palenight
  - pencil_dark
  - pencil_light
  - remedy_dark
  - rose-pine
  - rose-pine-moon
  - smoooooth
  - synthwave_84
  - tango_dark
  - tomorrow_night_bright
  - wombat
  - zenburn
https://github.com/dylanaraps/paleta/tree/master/palettes
https://github.com/tinted-theming/home - technically tools and themes
- https://github.com/tinted-theming/base16-putty
- https://github.com/iamthad/base16-windows-command-prompt
- https://github.com/InspectorMustache/base16-builder-python. - Todo my older version
Adwaita
- https://en.wikipedia.org/wiki/Adwaita_(design_language)#Color
- https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1.5/named-colors.html
pywal
- https://github.com/embark-theme/pywal
  - https://embark-theme.github.io/#palette
- https://codeberg.org/explosion-mental/wallust-themes/src/branch/master/colorschemes
vim
- https://github.com/twerth/ir_black/
- https://github.com/lifepillar/vim-wwdc16-theme/blob/master/colors/wwdc16.vim - note in Putty seems to work best when :set t_Co=16