ryanoasis /vim-devicons
Adds file type icons to Vim plugins such as: NERDTree, vim-airline, CtrlP, unite, Denite, lightline, vim-startify and many more
★ 5,806⑂ 277👁 61⑃ 176● 291▤ 39
More from this author
+0
Daily
5,806
stars
277
forks
61
watchers
176
prs
291
issues
39
releases
README
!version
!chat on gitter
!code of conduct
!prs welcome
!CI
Supports plugins such as NERDTree, vim-airline, CtrlP, powerline, denite, unite, lightline.vim, vim-startify, vimfiler, vim-buffet and flagship.
See Screenshots for more.
Features
--------
- Adds filetype glyphs (icons) to various vim plugins.
- Customizable and extendable glyphs settings.
- Supports a wide range of file type extensions.
- Supports popular full filenames, like .gitignore, node_modules, .vimrc, and many more.
- Supports byte order marker (BOM).
- Works with patched fonts, especially Nerd Fonts.
See Detailed Features for more.
See Configuration for a list of configuration and customization options.
Installation
------------
1. Install a Nerd Font compatible font or patch your own. Then set your terminal font (or guifont if you are using GUI version of Vim).
1. Install the Vim plugin with your favorite plugin manager, e.g. vim-plug:
vim
Plug 'ryanoasis/vim-devicons'
Always load the vim-devicons as the very last one.
1. Configure Vim
vim
set encoding=UTF-8
No need to set explicitly under Neovim: always uses UTF-8 as the default encoding.
See Installation for detailed setup instructions
Use :help devicons for further configuration.
Developers
----------
See DEVELOPER for how to use the API.
Troubleshooting
---------------
See FAQ.
Contributing
------------
Code of Conduct
This project has adopted a Code of Conduct that we expect project participants to adhere to. Check out code of conduct for further details.
Contributing Guide
Read our contributing guide to learn about how to send pull requests, creating issues properly.
Promotion
You can help us by simply giving a star or voting on vim.org. It will ensure continued development going forward.
- Star this repository on GitHub.
- Vote for it on vim.org.
Acknowledgments
---------------
Thanks goes to these people for inspiration and helping with sending PRs.
- vim-airline
- nerdtree
- nerdtree-git-plugin by @Xuyuanp
- seti-ui by @jesseweed
- devicons by @vorillaz
- development.svg.icons by @benatespina
- Learn Vimscript the Hard Way book by Steve Losh
- All contributors
License
-------
MITTop issues
#133icons in NERDtree can be only shown half.74 comments · 2015-12-19#106FZF Support? 50 comments · 2015-08-24#250The color of folder icon changed23 comments · 2018-11-13#266DCS control codes20 comments · 2019-04-15#158Coloured devicons out of the box17 comments · 2016-07-18#141vim ctrlspace15 comments · 2016-02-20#224Adding a new file via Nerdtree shows no icon14 comments · 2018-01-11#165Bracket problem with decorated folder node12 comments · 2016-09-15
Latest release
v0.11.0 v0.11.0 2019-02-17- Added Docker filetypes support (PR 228) (@IngoHeimbach) - Added Swift filetypes support (PR 252) (@motform) - Added Elixir filetypes support (PR 244) (@akoutmos) - Added configuration for 'prePadding' (fixes 231) - Added support for vue filetype extensions out-of-the-box (fixes 235) - Added configuration for 'DevIconsArtifactFix' (225) - Added leftrelease override to work on single mouse click (PR 246) (@Matrix86) - Added Travis CI with vim linting (PR 236) (@kutsan) - Fixed Vim-Startify no longer working "out of the box" (233) - Fixed Denite information being disc