ryanoasis/vim-devicons

Adds file type icons to Vim plugins such as: NERDTree, vim-airline, CtrlP, unite, Denite, lightline, vim-startify and many more

Vim Script

5,807

717 commits

updated May 9, 2024

See the code

README

VimDevIcons - Add Icons to Your Plugins

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.

vim-devicons overall screenshot

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).

  2. Install the Vim plugin with your favorite plugin manager, e.g. vim-plug:

    Plug 'ryanoasis/vim-devicons'
    

    Always load the vim-devicons as the very last one.

  3. Configure 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.

Acknowledgments

Thanks goes to these people for inspiration and helping with sending PRs.

License

MIT

eye-candy
filetype
glyph-icons
hacktoberfest
icons
nerd-fonts
nerdtree
powerline
statusline
theme
vim
vim-airline
viml
vim-plugins
vim-scripts
visualisation
visualization

Significant stargazers

(top 24 of 38)

Jess Frazelle

13,862 followers · starred Jun 2018

Jordan W

9,664 followers · starred Feb 2015

Jeff Widman

483 followers · starred Apr 2017

triallax

53 followers · starred Apr 2020

ryanoasis/vim-devicons

Adds file type icons to Vim plugins such as: NERDTree, vim-airline, CtrlP, unite, Denite, lightline, vim-startify and many more

Vim Script

5,807

717 commits

updated May 9, 2024

See the code

README

VimDevIcons - Add Icons to Your Plugins

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.

vim-devicons overall screenshot

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).

  2. Install the Vim plugin with your favorite plugin manager, e.g. vim-plug:

    Plug 'ryanoasis/vim-devicons'
    

    Always load the vim-devicons as the very last one.

  3. Configure 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.

Acknowledgments

Thanks goes to these people for inspiration and helping with sending PRs.

License

MIT

eye-candy
filetype
glyph-icons
hacktoberfest
icons
nerd-fonts
nerdtree
powerline
statusline
theme
vim
vim-airline
viml
vim-plugins
vim-scripts
visualisation
visualization

Significant stargazers

(top 24 of 38)

Jess Frazelle

13,862 followers · starred Jun 2018

Jordan W

9,664 followers · starred Feb 2015

Jeff Widman

483 followers · starred Apr 2017

triallax

53 followers · starred Apr 2020

Languages

Vim Script

96.8%

Python

3.2%