{"id":13706216,"url":"https://github.com/lifepillar/vim-solarized8","last_synced_at":"2025-05-16T06:04:15.633Z","repository":{"id":41203453,"uuid":"58920214","full_name":"lifepillar/vim-solarized8","owner":"lifepillar","description":"Optimized Solarized colorschemes. Best served with true-color terminals!","archived":false,"fork":false,"pushed_at":"2024-06-29T09:11:34.000Z","size":956,"stargazers_count":1029,"open_issues_count":2,"forks_count":95,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-05-16T06:03:10.822Z","etag":null,"topics":["color-scheme","vim"],"latest_commit_sha":null,"homepage":null,"language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lifepillar.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-05-16T09:27:10.000Z","updated_at":"2025-05-01T14:19:14.000Z","dependencies_parsed_at":"2024-01-08T21:47:19.507Z","dependency_job_id":"1df74e14-b2ea-4082-9c8e-276b6add3180","html_url":"https://github.com/lifepillar/vim-solarized8","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifepillar%2Fvim-solarized8","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifepillar%2Fvim-solarized8/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifepillar%2Fvim-solarized8/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifepillar%2Fvim-solarized8/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lifepillar","download_url":"https://codeload.github.com/lifepillar/vim-solarized8/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478186,"owners_count":22077675,"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":["color-scheme","vim"],"created_at":"2024-08-02T22:00:53.232Z","updated_at":"2025-05-16T06:04:15.612Z","avatar_url":"https://github.com/lifepillar.png","language":"Vim Script","funding_links":[],"categories":["Vim script","Vim Script","colorschemes"],"sub_categories":[],"readme":"# Solarized 8 for Vim\n\nSolarized 8 Flat Dark      |  Solarized 8 Flat Light\n:-------------------------:|:-------------------------:\n![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8_dark_flat.png)  |  ![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8_light_flat.png)\n\n**Note: if you are using Neovim, checkout the `neovim` branch of this repo.**\n\nThis is yet another Solarized theme for Vim. It places itself half way between\nthe original [Solarized](https://github.com/altercation/vim-colors-solarized)\nand the [Flattened](https://github.com/romainl/flattened) variant. It\nremoves only *some* of the bullshit. The color palette is exactly the same as\nin Solarized, although some highlight groups are defined slightly\ndifferently (for instance, I have tried to avoid red on blue).\n\nThe main reason for the existence of this project is that the original Solarized\ntheme does not define `guifg` and `guibg` in terminal Vim, making it unsuitable\nfor versions of Vim supporting true-color (i.e., 24-bit color) terminals.\nInstead, this color scheme works **out of the box everywhere**. For the best\nexperience, you need:\n\n- Vim ≥7.4.1799 with `termguicolors` set, **and**\n- a terminal supporting millions of colors (but see below for workarounds).\n\nSolarized 8 also works in any GUI version of Vim: no configuration is\nnecessary.\u003csup\u003e*\u003c/sup\u003e See below for installation instructions.\n\n\u003csup\u003e*\u003c/sup\u003e [VimR](https://github.com/qvacua/vimr) users must set\n`termguicolors` before loading the color scheme.\n\n\n## But, my terminal has only 256 colors!\n\nFor terminals not supporting true colors, Solarized 8 will fall back to use an\napproximate palette based on xterm's 256 colors, which looks more or less like\nthis:\n\nDark 256 color palette     |  Light 256 color palette\n:-------------------------:|:-------------------------:\n![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8_dark_256.png)  |  ![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8_light_256.png)\n\n(Yeah, it looks like a different color scheme: Solarized palette is far away\nfrom xterm colors!)\n\nIf you do not like this approximation, to get exact colors with such terminals\nyou have two possibilities:\n\n1. Modify some of your terminal colors in the range 16–255 to match Solarized\n   palette. For this purpose, you may run (*not* source!)\n   `scripts/solarized8.sh`; no setting is needed in Vim. For instance, if you\n   are using Bash, put this in `.bashrc`:\n\n   ```sh\n   sh /path/to/scripts/solarized.sh\n   ```\n\n   **Note:** this method is supported only by some terminals. For\n   instance, in Apple's Terminal.app, running `solarized.sh` has no effect.\n\n2. Set your terminal's 16 ANSI colors (the colors in the range 0–15) to the\n   Solarized palette (how to do that depends on the terminal) *and* `set\n   t_Co=16` in Vim to instruct Vim to use your terminal's colors. Be aware\n   that, if you force the use of your terminal colors in Vim with any of these\n   settings, but your terminal is not configured to use the Solarized palette,\n   your colors will be completely off!\n\n**Note:** whatever method you choose, keep in mind that if your terminal does\nnot support millions of colors, you must *not* set `termguicolors` (i.e., make\nsure that `set termguicolors?` outputs `notermguicolors`).\n\n\n## What if I happen to work on vt100 or similar?\n\nIn the past, Solarized 8 used to complain when your terminal did not support\nenough colors. But the current version will gracefully degrade to a (beautiful!)\nblack\u0026white color scheme:\n\nSolarized 8 B\u0026W variant    | Solarized 8 B\u0026W variant\n:-------------------------:|:-------------------------:\n![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8_bw.png)  |  ![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8_bw_solarized.png)\n\n\n## Installation\n\nIf your Vim supports packages (`echo has('packages')` prints `1`), I strongly\nrecommend that you use them. Just clone this repo inside `pack/*/opt`, e.g.:\n\n    git clone https://github.com/lifepillar/vim-solarized8.git \\\n        ~/.vim/pack/themes/opt/solarized8\n\nOtherwise, use you favourite installation method.\n\nThere are actually four optimized\u003csup\u003e*\u003c/sup\u003e color schemes you may load:\n\n- `solarized8_high`: high-contrast variant (screenshot below, first column);\n- `solarized8`: the default Solarized theme (screenshot below, second column);\n- `solarized8_low`: low-contrast variant (screenshot below, third column);\n- `solarized8_flat`: “flat” variant (screenshot below, fourth column).\n\n![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8-variants.png)\n\nThe “flat” variant does not exist in the original Solarized. It differs from\n`solarized8` mainly in how the status line, split bars and tab bar look like:\n\n![](https://raw.github.com/lifepillar/Resources/master/solarized8/solarized8-normal-vs-flat.png)\n\nTo use a Solarized 8 color scheme, set the background (`dark` or `light`) then\nload the variant you want, e.g.:\n\n```vim\nset background=dark\ncolorscheme solarized8\n```\n\nIf you opt to use some Vim plugin manager instead, the following should be\nadded to your `vimrc`, rather than the above, for the color scheme to be loaded\ncorrectly:\n\n```vim\nset background=dark\nautocmd vimenter * ++nested colorscheme solarized8\n```\n\nTo switch the background from dark to light or vice versa, just set `background`\naccordingly.\n\nIf you use Vim packages, there is no need to `packadd solarized8`. Keep your\n`runtimepath` clean!\n\n\u003csup\u003e*\u003c/sup\u003e Below is the result of a benchmark I have made using Vim 8.1.1450\n and iTerm 2 v3.2.6 on a MacBook Pro Early 2015 with macOS 10.14.5. To make the\n comparison meaningful, `g:solarized_extra_hi_groups` was set to `1`: Solarized\n 8 should load a bit faster if you do not enable additional syntax items. Note\n that Solarized 8 is optimized for what are believed to be the most common use\n cases, i.e., GUI, true-color terminals and 256-color terminals.\n\n\u003cp align=\"center\"\u003e\n\u003cimg width=\"500\" src=\"https://raw.github.com/lifepillar/Resources/master/solarized8/load_time.png\"\u003e\n\u003c/p\u003e\n\n\n## Options\n\nThe following options are inherited from Solarized, although their effects may\nbe slightly different from those in the original Solarized:\n\n- `g:solarized_visibility`: one of `\"normal\"` (default), `\"low\"`, `\"high\"`:\n  controls `CursorLineNr`, `LineNr`, `NonText`, `SpecialKey`, `Title`, and all\n  the `Spell*` highlight groups; in light mode, it may also slightly change the\n  color for `Cursor` and `MatchParen`;\n- `g:solarized_diffmode`: one of `\"normal\"` (default), `\"low\"`, `\"high\"`:\n  controls the style of `DiffAdd`, `DiffChange`, `DiffDelete`, and `DiffText`.\n- `g:solarized_termtrans`: make the background transparent if set to `1`\n  (default: `0`). This has effect only if Vim is run from the terminal.\n\nThe following options were not available in the original Solarized:\n\n- `g:solarized_statusline`: one of `\"normal\"` (default), `\"low\"` or `\"flat\"`.\n  This affects the “structural” elements of your editor: `StatusLine`,\n  `StatusLineNC`, `TabLine`, `TablineFill`, `TabLineSel`, and `VertSplit`.\n- `g:solarized_italics`: set to `0` to suppress italics (default is `1`). Note\n  that in the terminal whether italics is actually used depends also on the\n  font and the terminal environment: setting this option to `1` is not\n  guaranteed to work.\n- `g:solarized_old_cursor_style`: set to `1` if you want to use the original\n  Solarized's cursor style (default: `0`). By default, the cursor is orange or\n  red in light themes (depending on `g:solarized_visibility`), and blue in dark\n  themes. Please note that your terminal may override the cursor's color, so\n  this option is not guaranteed to change the cursor's color.\n- `g:solarized_extra_hi_groups`: set to `1` to enable Solarized\n  filetype-specific syntax highlighting groups (default is `0`). Please be\n  aware that if your Vim is very old you may encounter [an\n  issue](https://github.com/vim/vim/issues/4405) with syntax items defined in\n  color schemes.\n\nAll these options may be used with any Solarized 8 variant.\n\n\n## Troubleshooting\n\n**Hey, I do not get the right colors when running Vim inside tmux or in my\nfavourite true-color enabled terminal!**\n\nTry putting this in your `.vimrc`:\n\n```viml\nlet \u0026t_8f = \"\\\u003cEsc\u003e[38;2;%lu;%lu;%lum\"\nlet \u0026t_8b = \"\\\u003cEsc\u003e[48;2;%lu;%lu;%lum\"\n```\n\nSee `:h xterm-true-color` for the details.\n\nIt may also be necessary to add the following to your `tmux.conf`:\n\n```\n# Add truecolor support\nset-option -ga terminal-overrides \",xterm-256color:Tc\"\n# Default terminal is 256 colors\nset -g default-terminal \"tmux-256color\"\n```\n\nSee also these threads:\n\n- [Colors are off when running Vim via SSH inside tmux](https://github.com/lifepillar/vim-solarized8/issues/4#issuecomment-985416964)\n- [Comments look weird in tmux](https://github.com/lifepillar/vim-solarized8/issues/109)\n\n\n\n## Hacking\n\nDo you want to hack the theme? Install\n[Colortemplate](https://github.com/lifepillar/vim-colortemplate), edit the\n`templates/*.colortemplate` files, then rebuild the color schemes.\n\nIf you extend or improve Solarized 8, please consider submitting a pull request!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flifepillar%2Fvim-solarized8","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flifepillar%2Fvim-solarized8","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flifepillar%2Fvim-solarized8/lists"}