{"id":13503350,"url":"https://github.com/blueyed/vim-diminactive","last_synced_at":"2025-09-08T04:44:27.849Z","repository":{"id":13962587,"uuid":"16663031","full_name":"blueyed/vim-diminactive","owner":"blueyed","description":"Vim plugin to dim inactive windows","archived":false,"fork":false,"pushed_at":"2021-09-25T08:18:02.000Z","size":170,"stargazers_count":340,"open_issues_count":15,"forks_count":10,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-29T17:43:36.069Z","etag":null,"topics":[],"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/blueyed.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}},"created_at":"2014-02-09T08:46:20.000Z","updated_at":"2025-01-15T11:53:42.000Z","dependencies_parsed_at":"2022-08-07T07:16:02.520Z","dependency_job_id":null,"html_url":"https://github.com/blueyed/vim-diminactive","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/blueyed%2Fvim-diminactive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blueyed%2Fvim-diminactive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blueyed%2Fvim-diminactive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blueyed%2Fvim-diminactive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blueyed","download_url":"https://codeload.github.com/blueyed/vim-diminactive/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247657281,"owners_count":20974345,"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-31T22:02:47.924Z","updated_at":"2025-04-07T13:09:26.209Z","avatar_url":"https://github.com/blueyed.png","language":"Vim script","funding_links":[],"categories":["Vim Script","Tools","Plugins / Themes / Dependencies"],"sub_categories":["Interface"],"readme":"# diminactive.vim\n\nThis is a plugin for Vim to dim inactive windows.\n\n[![Build Status](https://travis-ci.org/blueyed/vim-diminactive.svg?branch=master)](https://travis-ci.org/blueyed/vim-diminactive)\n\n## Screenshot\n\n![Screenshot](screenshot.png)\n\n## Screencast\n\n[![asciicast](https://asciinema.org/a/13855.png)](https://asciinema.org/a/13855)\n\n## Methods\n\nIt provides two methods, which can be used independent:\n\n### The `colorcolumn` method\n\nWith this method `colorcolumn` gets set to a list containing every column for\nthe inactive windows, effectively resulting in a different background color\n(see `hl-CursorColumn`).\n\nThis is enabled by default and can be disabled, e.g. if you want to use the\nsyntax method only:\n\n    let g:diminactive_use_colorcolumn = 0\n\n### Highlighting group\n\nVim's ColorColumn highlighting group is being used for this, which is red by\ndefault, and pink if undefined):\n\n    :hi ColorColumn\n    ColorColumn    xxx term=reverse ctermbg=1 guibg=DarkRed\n\nYou can define a custom color yourself, in case your colorscheme does not use\nsomething sensible:\n\n    :hi ColorColumn ctermbg=0 guibg=#eee8d5\n\n### The `syntax` method\n\nThere is an option to disable syntax highlighting for inactive windows. It is\ndisabled by default, and you can enable it using:\n\n    let g:diminactive_use_syntax = 1\n\n### `FocusLost` and `FocusGained` events\n\nYou can enable (un)dimming windows on Vim's `FocusLost` and `FocusGained`\nevents by adding the following line to your `.vimrc` (defaults to 0):\n\n    let g:diminactive_enable_focus = 1\n\n**NOTE**: If you are using tmux it is recommended to install the\n[vim-tmux-focus-events][3] plugin for Vim and add `set -g focus-events on`\nto your `~/.tmux.conf` to enable better support for Vim's `FocusLost` and\n`FocusGained` events in tmux.\n\n## Commands\n\nThe following commands are provided to control it:\n\n### Global control\n - DimInactive / DimInactiveOn\n - DimInactiveOff\n - DimInactiveToggle\n\n - DimInactiveSyntaxOn\n - DimInactiveSyntaxOff\n\n - DimInactiveColorcolumnOn\n - DimInactiveColorcolumnOff\n\n### Control on the window level\nDimming can be controlled on the window level, which overrides any buffer-local\nconfiguration (a buffer can be displayed in multiple windows).\n\n#### `DimInactiveWindowOff`\nDisable for this window.\n\n#### `DimInactiveWindowOn`\nEnable for this window.\n\n#### `DimInactiveWindowReset`\nReset config on window level.\n\n### Control on the buffer level\nDimming can be controlled on the buffer level.\nThis gets overridden by window-local configuration (a buffer can be displayed\nin multiple windows).\n\n#### `DimInactiveBufferOff`\nDisable for this buffer.\n\n#### `DimInactiveBufferOn`\nEnable for this buffer.\n\n#### `DimInactiveBufferReset`\nReset config on buffer level.\n\n## Filtering buffers\n\nYou can disable the dimming based on `buftype` or `filetype` with the\nfollowing settings.\n\n### `g:diminactive_buftype_blacklist`\n\nA list of buffer types where dimming gets disabled. Default:\n\n    let g:diminactive_buftype_blacklist = ['nofile', 'nowrite', 'acwrite', 'quickfix', 'help']\n\n### `g:diminactive_filetype_blacklist`\n\nA list of filetypes where dimming gets disabled. Default:\n\n    let g:diminactive_filetype_blacklist = ['startify']\n\n### `g:diminactive_buftype_whitelist`\n\nA list of buffer types where dimming gets enabled (overrides the blacklist).\nDefault:\n\n    let g:diminactive_buftype_whitelist = []\n\n### `g:diminactive_filetype_whitelist`\n\nA list of filetypes where dimming gets enabled (overrides the whitelist).\nDefault:\n\n    let g:diminactive_filetype_whitelist = ['dirvish']\n\n## Credits\n\nIt is based on an [idea from Paul Isambert][1], which got turned into a\n[StackOverflow answer][2] and then into a plugin, incorporating the\nsuggestions made by joeytwiddle.\n\n## Caveats\n* It might slow down redrawing of windows.\n* It will only work with lines containing text (i.e. not `~` (non-lines)).\n\n## Related plugins\n\n* The [cursorcross.vim](https://github.com/mtth/cursorcross.vim) plugin\n  provides automatic and \"refreshingly sane `cursorcolumn` and `cursorline`\n  handling\".\n* The [ZoomWin](http://drchip.org/astronaut/vim/index.html#ZOOMWIN) plugin\n  allows to (un-)maximize the current window.\n* [goyo.vim](https://github.com/junegunn/goyo.vim) provides distraction-free\n  writing in Vim.\n\n[1]: https://groups.google.com/d/msg/vim_use/IJU-Vk-QLJE/xz4hjPjCRBUJ\n[2]: http://stackoverflow.com/a/12519572/15690\n[3]: https://github.com/tmux-plugins/vim-tmux-focus-events\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblueyed%2Fvim-diminactive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblueyed%2Fvim-diminactive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblueyed%2Fvim-diminactive/lists"}