{"id":13897746,"url":"https://github.com/tinted-theming/base16-shell-legacy","last_synced_at":"2025-07-17T14:32:43.637Z","repository":{"id":36964354,"uuid":"330157067","full_name":"tinted-theming/base16-shell-legacy","owner":"tinted-theming","description":"Base16 for Shells","archived":true,"fork":false,"pushed_at":"2022-06-30T18:13:19.000Z","size":886,"stargazers_count":20,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-25T03:33:06.093Z","etag":null,"topics":["base16","base16-theme","bash","fish","shell","theme","zsh"],"latest_commit_sha":null,"homepage":"https://github.com/base16-project/base16","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","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.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-16T12:24:53.000Z","updated_at":"2024-08-12T20:09:28.000Z","dependencies_parsed_at":"2022-07-11T11:33:50.921Z","dependency_job_id":null,"html_url":"https://github.com/tinted-theming/base16-shell-legacy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tinted-theming/base16-shell-legacy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Fbase16-shell-legacy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Fbase16-shell-legacy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Fbase16-shell-legacy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Fbase16-shell-legacy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tinted-theming","download_url":"https://codeload.github.com/tinted-theming/base16-shell-legacy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinted-theming%2Fbase16-shell-legacy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265616863,"owners_count":23798910,"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","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","base16-theme","bash","fish","shell","theme","zsh"],"created_at":"2024-08-06T18:03:50.919Z","updated_at":"2025-07-17T14:32:43.312Z","avatar_url":"https://github.com/tinted-theming.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Base16 Shell\n\nSee the [Base16 repository][1] for more information.\n\nA shell script to change your shell's default ANSI colors but most\nimportantly, colors 17 to 21 of your shell's 256 colorspace (if\nsupported by your terminal). This script makes it possible to honor the\noriginal bright colors of your shell (e.g. bright green is still green\nand so on) while providing additional base16 colors to applications such\nas Vim and tmux.\n\n![Base16 Shell][8]\n\n## Use Cases\n\n- You want to use a `*.256.*` variant of a Terminal theme designed to\n  honor the original bright colors.\n- You prefer to use a script instead of a terminal emulator theme to\n  color your shell.\n- You use this script to have different colorschemes appear on different\n  SSH sessions.\n\n## Installation\n\n```shell\ngit clone https://github.com/base16-project/base16-shell.git \\\n  $HOME/.config/base16-shell\n```\n\n### Bash/ZSH\n\nAdd following lines to `.bashrc` or `.zshrc`:\n\n```bash\n# Base16 Shell\nBASE16_SHELL_PATH=\"$HOME/.config/base16-shell\"\n[ -n \"$PS1\" ] \u0026\u0026 \\\n  [ -s \"$BASE16_SHELL_PATH/profile_helper.sh\" ] \u0026\u0026 \\\n    source \"$BASE16_SHELL_PATH/profile_helper.sh\"\n```\n\n### Oh my zsh\n\n```bash\nmkdir $HOME/.oh-my-zsh/plugins/base16-shell\nln -s $HOME/.config/base16-shell/base16-shell.plugin.zsh \\\n  $HOME/.oh-my-zsh/plugins/base16-shell/base16-shell.plugin.zsh\n```\n\nTo use it, add `base16-shell` to the plugins array in your `.zshrc` file:\n\n`plugins=(... base16-shell)`\n\n### Fish\n\nAdd following lines to `$HOME/.config/fish/config.fish`:\n\n```fish\n# Base16 Shell\nif status --is-interactive\n  set BASE16_SHELL_PATH \"$HOME/.config/base16-shell\"\n  source \"$BASE16_SHELL_PATH/profile_helper.fish\"\nend\n```\n\n## Configuration\n\n### Base16-Vim Users\n\n#### Vim\n\nThe `BASE16_THEME` environment variable will set to your current\ncolorscheme. You can set the [base16-vim][2] colorscheme to the\n`BASE16_THEME` environment variable by adding the following to your\n`.vimrc`:\n\n```vim\nif exists('$BASE16_THEME')\n    \\ \u0026\u0026 (!exists('g:colors_name') \n    \\ || g:colors_name != 'base16-$BASE16_THEME')\n  let base16colorspace=256\n  colorscheme base16-$BASE16_THEME\nendif\n```\n\nRemove the `base16colorspace` line if it is not needed.\n\n#### Neovim\n\nIf you have a lua neovim config, add the following to your `init.lua`:\n\n```lua\nlocal cmd = vim.cmd\nlocal g = vim.g\n\nlocal base16_project_theme = os.getenv('BASE16_THEME')\nif base16_project_theme and g.colors_name ~= 'base16-'..base16_project_theme then\n  cmd('let base16colorspace=256')\n  cmd('colorscheme base16-'..base16_project_theme)\nend\n```\n\n### Base16-Tmux Users\n\nThis section is for [base16-tmux][3] users. base16-shell will update (or\ncreate) the `$HOME/.config/base16-project/tmux.base16.conf` file and\nset the colorscheme. You need to source this file in your `.tmux.conf`.\nYou can do this by adding the following to your `.tmux.conf`:\n\n```\nsource-file $HOME/.config/base16-project/tmux.base16.conf\n```\n\nMake sure to reload your `.tmux.conf` file after the theme has been\nupdated through `profile_helper`.\n\n### Keeping your themes up to date\n\nTo update, just `git pull` wherever you've cloned `base16-shell`. The\nthemes are updated on a weekly basis thanks to GitHub Actions. See the\nGitHub Actions workflow in [`.github/workflows/update.yml`][6].\n\n### Default theme\n\nYou can set the `$BASE16_THEME_DEFAULT` environment variable to the name\nof a theme and it will use that theme if there is no theme currently\nset. This can be useful for when you're using your dotfiles in a brand\nnew environment and you don't want to manually set the theme for the\nfirst time.\n\nFor example: `$BASE16_THEME_DEFAULT=\"solarized-light\"` \n\n## Usage\n\nOpen a new shell and type `base16` followed by a tab to perform tab\ncompletion.\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][9]\n\nIf **colortest** is run without any arguments e.g. `./colortest` the hex\nvalues shown will correspond to the default scheme. If you'd like to see\nthe hex values for a particular scheme pass the file name of the theme\nas the arguement e.g. `./colortest base16-ocean.sh`.\n\n### Inverted blacks and whites\n\nThis is the expected behaviour when using a light theme:\nhttps://github.com/base16-project/base16-shell/issues/150\n\n## Contributing\n\nSee [`CONTRIBUTING.md`][7], which contains building and contributing\ninstructions.\n\n[1]: https://github.com/base16-project/base16\n[2]: https://github.com/base16-project/base16-vim\n[3]: https://github.com/mattdavis90/base16-tmux\n[4]: https://github.com/base16-project/base16-builder-go\n[5]: https://formulae.brew.sh\n[6]: .github/workflows/update.yml\n[7]: CONTRIBUTING.md\n[8]: screenshots/base16-shell.png\n[9]: screenshots/setting-256-colourspace-not-supported.png\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinted-theming%2Fbase16-shell-legacy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinted-theming%2Fbase16-shell-legacy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinted-theming%2Fbase16-shell-legacy/lists"}