{"id":13429314,"url":"https://github.com/altercation/vim-colors-solarized","last_synced_at":"2025-05-14T07:08:28.690Z","repository":{"id":39706867,"uuid":"1381275","full_name":"altercation/vim-colors-solarized","owner":"altercation","description":"precision colorscheme for the vim text editor","archived":false,"fork":false,"pushed_at":"2024-04-10T14:44:21.000Z","size":772,"stargazers_count":6613,"open_issues_count":134,"forks_count":1752,"subscribers_count":171,"default_branch":"master","last_synced_at":"2025-04-13T17:46:36.680Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://ethanschoonover.com/solarized","language":"VimL","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/altercation.png","metadata":{"files":{"readme":"README.mkd","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":"2011-02-18T05:16:38.000Z","updated_at":"2025-04-09T09:09:52.000Z","dependencies_parsed_at":"2022-07-13T12:10:47.517Z","dependency_job_id":"5dc9d932-1fa7-4aa2-be4e-19b8dfd211b3","html_url":"https://github.com/altercation/vim-colors-solarized","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altercation%2Fvim-colors-solarized","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altercation%2Fvim-colors-solarized/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altercation%2Fvim-colors-solarized/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altercation%2Fvim-colors-solarized/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/altercation","download_url":"https://codeload.github.com/altercation/vim-colors-solarized/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254092776,"owners_count":22013290,"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":[],"created_at":"2024-07-31T02:00:34.139Z","updated_at":"2025-05-14T07:08:28.670Z","avatar_url":"https://github.com/altercation.png","language":"VimL","funding_links":[],"categories":["Editor Utilities","Vim Script","Visual settings:","VimL (1)","VimL","Included color schemes","Vim","Basics","Colors"],"sub_categories":["Installing","Vim Solarized theme:","Install for multiple users","Chess :chess_pawn:","[Vim](http://www.vim.org)"],"readme":"---\nTitle: Solarized Colorscheme for Vim\nDescription: Precision colors for machines and people\nAuthor: Ethan Schoonover\nColors: light yellow\nCreated:  2011 Mar 15\nModified: 2011 Apr 16\n\n---\n\nSolarized Colorscheme for Vim\n=============================\n\nDeveloped by Ethan Schoonover \u003ces@ethanschoonover.com\u003e\n\nVisit the [Solarized homepage]\n------------------------------\n\nSee the [Solarized homepage] for screenshots, \ndetails and colorscheme versions for Vim, Mutt, popular terminal emulators and \nother applications.\n\nScreenshots\n-----------\n\n![solarized dark](https://github.com/altercation/solarized/raw/master/img/solarized-vim.png)\n\nDownloads\n---------\n\nIf you have come across this colorscheme via the [Vim-only repository] on \ngithub, or the [vim.org script] page see the link above to the Solarized \nhomepage or visit the main [Solarized repository].\n\nThe [Vim-only repository] is kept in sync with the main [Solarized repository] \nand is for installation convenience only (with [Pathogen] or [Vundle], for \ninstance).  Issues, bug reports, changelogs are centralized at the main \n[Solarized repository].\n\n[Solarized homepage]:   http://ethanschoonover.com/solarized\n[Solarized repository]: https://github.com/altercation/solarized\n[Vim-only repository]:  https://github.com/altercation/vim-colors-solarized\n[vimorg-script]:        http://vim.org/script\n[Pathogen]:             https://github.com/tpope/vim-pathogen\n[Vundle]:               https://github.com/gmarik/vundle\n\nInstallation\n------------\n\n### Option 1: Manual installation\n\n1.  Move `solarized.vim` to your `.vim/colors` directory. After downloading the \n    vim script or package:\n\n        $ cd vim-colors-solarized/colors\n        $ mv solarized.vim ~/.vim/colors/\n\n### Option 2: Pathogen installation ***(recommended)***\n\n1.  Download and install Tim Pope's [Pathogen].\n\n2.  Next, move or clone the `vim-colors-solarized` directory so that it is \n    a subdirectory of the `.vim/bundle` directory.\n\n    a. **Clone:** \n\n            $ cd ~/.vim/bundle\n            $ git clone git://github.com/altercation/vim-colors-solarized.git\n\n    b. **Move:**\n\n        In the parent directory of vim-colors-solarized:\n        \n            $ mv vim-colors-solarized ~/.vim/bundle/\n\n### Modify .vimrc\n\nAfter either Option 1 or Option 2 above, put the following two lines in your \n.vimrc:\n\n    syntax enable\n    set background=dark\n    colorscheme solarized\n\nor, for the light background mode of Solarized:\n\n    syntax enable\n    set background=light\n    colorscheme solarized\n\nI like to have a different background in GUI and terminal modes, so I can use \nthe following if-then. However, I find vim's background autodetection to be \npretty good and, at least with MacVim, I can leave this background value \nassignment out entirely and get the same results.\n\n    if has('gui_running')\n        set background=light\n    else\n        set background=dark\n    endif\n\nSee the [Solarized homepage] for screenshots which will help you \nselect either the light or dark background.\n\n### IMPORTANT NOTE FOR TERMINAL USERS:\n\nIf you are going to use Solarized in Terminal mode (i.e. not in a GUI version \nlike gvim or macvim), **please please please** consider setting your terminal \nemulator's colorscheme to used the Solarized palette. I've included palettes \nfor some popular terminal emulator as well as Xdefaults in the official \nSolarized download available from [Solarized homepage]. If you use \nSolarized *without* these colors, Solarized will need to be told to degrade its\ncolorscheme to a set compatible with the limited 256 terminal palette (whereas \nby using the terminal's 16 ansi color values, you can set the correct, specific \nvalues for the Solarized palette).\n\nIf you do use the custom terminal colors, solarized.vim should work out of the\nbox for you. If you are using a terminal emulator that supports 256 colors and \ndon't want to use the custom Solarized terminal colors, you will need to use \nthe degraded 256 colorscheme. To do so, simply add the following line *before* \nthe `colorschem solarized` line:\n\n    let g:solarized_termcolors=256\n\nAgain, I recommend just changing your terminal colors to Solarized values \neither manually or via one of the many terminal schemes available for import.\n\nAdvanced Configuration\n----------------------\n\nSolarized will work out of the box with just the two lines specified above but \ndoes include several other options that can be set in your .vimrc file.\n\nSet these in your vimrc file prior to calling the colorscheme.\n\"\n    option name               default     optional\n    ------------------------------------------------\n    g:solarized_termcolors=   16      |   256\n    g:solarized_termtrans =   0       |   1\n    g:solarized_degrade   =   0       |   1\n    g:solarized_bold      =   1       |   0\n    g:solarized_underline =   1       |   0\n    g:solarized_italic    =   1       |   0\n    g:solarized_contrast  =   \"normal\"|   \"high\" or \"low\"\n    g:solarized_visibility=   \"normal\"|   \"high\" or \"low\"\n    ------------------------------------------------\n\n### Option Details\n\n*   g:solarized_termcolors\n\n    This is set to *16* by default, meaning that Solarized will attempt to use \n    the standard 16 colors of your terminal emulator. You will need to set \n    those colors to the correct Solarized values either manually or by \n    importing one of the many colorscheme available for popular terminal \n    emulators and Xdefaults.\n\n*   g:solarized_termtrans\n\n    If you use a terminal emulator with a transparent background and Solarized \n    isn't displaying the background color transparently, set this to 1 and \n    Solarized will use the default (transparent) background of the terminal \n    emulator. *urxvt* required this in my testing; iTerm2 did not.\n\n    Note that on Mac OS X Terminal.app, solarized_termtrans is set to 1 by \n    default as this is almost always the best option. The only exception to \n    this is if the working terminfo file supports 256 colors (xterm-256color).\n\n*   g:solarized_degrade\n\n    For test purposes only; forces Solarized to use the 256 degraded color mode \n    to test the approximate color values for accuracy.\n\n*   g:solarized_bold | g:solarized_underline | g:solarized_italic\n\n    If you wish to stop Solarized from displaying bold, underlined or \n    italicized typefaces, simply assign a zero value to the appropriate \n    variable, for example: `let g:solarized_italic=0`\n\n*   g:solarized_contrast\n\n    Stick with normal! It's been carefully tested. Setting this option to high \n    or low does use the same Solarized palette but simply shifts some values up \n    or down in order to expand or compress the tonal range displayed.\n\n*   g:solarized_visibility\n\n    Special characters such as trailing whitespace, tabs, newlines, when\n    displayed using `:set list` can be set to one of three levels depending on \n    your needs. Default value is `normal` with `high` and `low` options.\n\nToggle Background Function\n--------------------------\n\nSolarized comes with a Toggle Background plugin that by default will map to \n\u003cF5\u003e if that mapping is available. If it is not available you will need to \neither map the function manually or change your current \u003cF5\u003e mapping to \nsomething else.\n\nTo set your own mapping in your .vimrc file, simply add the following line to \nsupport normal, insert and visual mode usage, changing the \"\u003cF5\u003e\" value to the \nkey or key combination you wish to use:\n\n    call togglebg#map(\"\u003cF5\u003e\")\n\nNote that you'll want to use a single function key or equivalent if you want \nthe plugin to work in all modes (normal, insert, visual).\n\nCode Notes\n----------\n\nUse folding to view the `solarized.vim` script with `foldmethod=marker` turned \non.\n\nI have attempted to modularize the creation of Vim colorschemes in this script \nand, while it could be refactored further, it should be a good foundation for \nthe creation of any color scheme. By simply changing the sixteen values in the \nGUI section and testing in gvim (or mvim) you can rapidly prototype new \ncolorschemes without diving into the weeds of line-item editing each syntax \nhighlight declaration.\n\nThe Values\n----------\n\nL\\*a\\*b values are canonical (White D65, Reference D50), other values are \nmatched in sRGB space.\n\n    SOLARIZED HEX     16/8 TERMCOL  XTERM/HEX   L*A*B      sRGB        HSB\n    --------- ------- ---- -------  ----------- ---------- ----------- -----------\n    base03    #002b36  8/4 brblack  234 #1c1c1c 15 -12 -12   0  43  54 193 100  21\n    base02    #073642  0/4 black    235 #262626 20 -12 -12   7  54  66 192  90  26\n    base01    #586e75 10/7 brgreen  240 #4e4e4e 45 -07 -07  88 110 117 194  25  46\n    base00    #657b83 11/7 bryellow 241 #585858 50 -07 -07 101 123 131 195  23  51\n    base0     #839496 12/6 brblue   244 #808080 60 -06 -03 131 148 150 186  13  59\n    base1     #93a1a1 14/4 brcyan   245 #8a8a8a 65 -05 -02 147 161 161 180   9  63\n    base2     #eee8d5  7/7 white    254 #d7d7af 92 -00  10 238 232 213  44  11  93\n    base3     #fdf6e3 15/7 brwhite  230 #ffffd7 97  00  10 253 246 227  44  10  99\n    yellow    #b58900  3/3 yellow   136 #af8700 60  10  65 181 137   0  45 100  71\n    orange    #cb4b16  9/3 brred    166 #d75f00 50  50  55 203  75  22  18  89  80\n    red       #dc322f  1/1 red      160 #d70000 50  65  45 220  50  47   1  79  86\n    magenta   #d33682  5/5 magenta  125 #af005f 50  65 -05 211  54 130 331  74  83\n    violet    #6c71c4 13/5 brmagenta 61 #5f5faf 50  15 -45 108 113 196 237  45  77\n    blue      #268bd2  4/4 blue      33 #0087ff 55 -10 -45  38 139 210 205  82  82\n    cyan      #2aa198  6/6 cyan      37 #00afaf 60 -35 -05  42 161 152 175  74  63\n    green     #859900  2/2 green     64 #5f8700 60 -20  65 133 153   0  68 100  60\n\nLicense\n-------\nCopyright (c) 2011 Ethan Schoonover\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltercation%2Fvim-colors-solarized","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faltercation%2Fvim-colors-solarized","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltercation%2Fvim-colors-solarized/lists"}