{"id":29212049,"url":"https://github.com/tinted-theming/tinted-shell","last_synced_at":"2025-10-07T23:12:09.764Z","repository":{"id":7419992,"uuid":"8754325","full_name":"tinted-theming/tinted-shell","owner":"tinted-theming","description":"Base16 and Base24 for Shells","archived":false,"fork":false,"pushed_at":"2025-08-03T14:28:26.000Z","size":1974,"stargazers_count":70,"open_issues_count":2,"forks_count":217,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-08-03T16:20:12.287Z","etag":null,"topics":["base16","base24","bash","fish","shell","theme","themes","zsh"],"latest_commit_sha":null,"homepage":"https://github.com/tinted-theming/home","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"chriskempson/base16-shell","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tinted-theming.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-03-13T14:43:56.000Z","updated_at":"2025-08-03T14:28:30.000Z","dependencies_parsed_at":"2023-11-22T00:56:15.626Z","dependency_job_id":"c58e5e6a-77fb-47e2-8f1c-a192bdcc4bc1","html_url":"https://github.com/tinted-theming/tinted-shell","commit_stats":null,"previous_names":["tinted-theming/base16-shell"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tinted-theming/tinted-shell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Ftinted-shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Ftinted-shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Ftinted-shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Ftinted-shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tinted-theming","download_url":"https://codeload.github.com/tinted-theming/tinted-shell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Ftinted-shell/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278861029,"owners_count":26058632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["base16","base24","bash","fish","shell","theme","themes","zsh"],"created_at":"2025-07-02T22:06:53.795Z","updated_at":"2025-10-07T23:12:09.747Z","avatar_url":"https://github.com/tinted-theming.png","language":"Shell","funding_links":[],"categories":["Plugins"],"sub_categories":["ZSH on Windows"],"readme":"# Tinted Shell\n\n[![Matrix Chat](https://img.shields.io/matrix/tinted-theming:matrix.org)](https://matrix.to/#/#tinted-theming:matrix.org)\n\nA shell script to change your shell's default ANSI colors. This includes\n256 color support if your terminal supports it. This script makes it\npossible to honor the original bright colors of your shell. The ANSI\ncolors are mapped correctly. (e.g. green is still green). Tinted Shell\nalso provides additional colors to applications such as Vim and tmux.\n\nHave a look at our [Base16 Gallery] to see the various themes supported\nby Tinted Shell. For more information about [Base16] or [Base24], have a\nlook at the [Tinted Theming] Home repository.\n\n![Shell image]\n\nNote: tinted-shell currently has 2 functions:\n\n1. It contains shell script themes in `scripts/*.sh` which one can use\n   to set their shell color theme.\n2. There is a \"profile_helper\" which is used to manage the settings of\n   themes throughout the system. This manager can be hooked up to all\n   other tinted templates and changing a theme in tinted-shell will\n   change all themes throughout the system.\n\nIf you are using tinted-shell for point number 2, we suggest using\n[Tinty] as your theme manager instead, which uses tinted-shell\n`scripts/*.sh` themesunder the hood by default. More information under\n[Theme Managers](#theme-managers).\n\n## Use Cases for using a script to theme your shell\n\n- Portability Across Different Terminal Emulators and SSH sessions.\n- Integration with shell prompts and CLI tools.\n- Compatibility with Text-Based Applications and Scripts.\n\n## Usage\n\nClone the repo locally and execute the script with your posix compliant\nshell (sh, bash, zsh, etc).\n\n```sh\ncd path/to/cloned/repo/tinted-shell\nsh ./scripts/base16-mocha.sh\n```\n\n### Theme managers\n\nThis repository has a profile_helper shell script which it has used to\n\"manage\" theme switching for a long time. It's evolved to include \"hook\"\nscripts which allow users to change other base16 template themes when a\ntheme is set.\n\nIt has grown a lot and we decided to build a more robust theming manager\ntool, written in Rust, called [Tinty]. At first we were unsure whether\nit was going to be part of this repository or not, but since it wasn't\ndirectory related to tinted-shell (much like profile_helper isn't very\nrelated) we decided to move it to its own repository. \n\nWith [Tinty] you can switch your shell theme, or any other base16,\nbase24 or Tinted Theming theme, by running a single command, eg: `tinty\napply base16-mocha`. Read more about it on the [Tinty] repository.\n\nWhile we aren't removing the profile_helper, it isn't going to be\nactively grown anymore since that effort is going into [Tinty]. But, you\ncan use the Profile Helper shell script. You can read more about it in\n[USAGE.md].\n\n### Customization\n\nThere are times when templates don't exist for command line\napplications, or perhaps you just want to play around with colors\nyourself. You can access these colors by having them set as environment\nvariables.\n\n#### Base16\n\nAdd `export TINTED_SHELL_ENABLE_BASE16_VARS=1` to your `.*rc` file and make\nsure the variable is set before running the theme script to enable this\nfeature.\n\nThis feature enables env vars `BASE16_COLOR_01_HEX` to\n`BASE16_COLOR_0F_HEX`. Have a look at the [Base16 Styling Guidelines]\nfor more styling information.\n\n#### Base24\n\nAdd `export TINTED_SHELL_ENABLE_BASE24_VARS=1` to your `.*rc` file and make\nsure the variable is set before running the theme script to enable this\nfeature.\n\nThis feature enables env vars `BASE24_COLOR_01_HEX` to\n`BASE24_COLOR_0F_HEX`. Have a look at the [Base24 Styling Guidelines]\nfor more styling information.\n\nThis feature enables env vars `BASE16_COLOR_01_HEX` to\n`BASE16_COLOR_0F_HEX`.\n\n## Troubleshooting\n\nRun the included **colortest** script and check that your colour\nassignments appear correct. If your teminal does not support the setting\nof colours in within the 256 colorspace (e.g. Apple Terminal), colours\n17 to 21 will appear blue.\n\n![setting 256 colourspace not supported]\n\nIf `colortest` is run without any arguments e.g. `./colortest` the hex\nvalues shown will correspond to the currently set theme. If you'd like\nto see the hex values for a particular scheme pass the file name of the\ntheme name as the arguement e.g. `./colortest base16-mocha`.\n\n## Contributing\n\nSee [CONTRIBUTING.md], which contains building and contributing\ninstructions.\n\n[Tinted Theming]: https://github.com/tinted-theming/home\n[CONTRIBUTING.md]: CONTRIBUTING.md\n[Shell image]: screenshots/tinted-shell.png\n[Base16]: https://github.com/tinted-theming/home/blob/main/styling.md\n[Base24]: https://github.com/tinted-theming/base24/blob/master/styling.md\n[setting 256 colourspace not supported]: screenshots/setting-256-colourspace-not-supported.png\n[Tinty]: https://github.com/tinted-theming/tinty\n[USAGE.md]: USAGE.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinted-theming%2Ftinted-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinted-theming%2Ftinted-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinted-theming%2Ftinted-shell/lists"}