github github
stars 165
issues 9
subscribers 5
forks 3



5 months ago

[!NOTE] Due to lack of time, this plugin has been archived. Please switch to a newer and maintained 3rd/image.nvim.


  • Supports many file formats (.png, .jpg, .jpeg, .bmp, .webp, ...)
  • Colored images
  • Almost no code runs on startup
  • Rendering with a dither method makes images more visible than traditional ascii art
  • Images are centered and have labels!

How does it work?

When you open an image file (e.g. portrait.png), the open buffer becomes non-editable and non-saveable to ensure the file contents won't be overwritten. Then the buffer is filled with the ascii art generated by ascii-image-converter. I found out that a plugin similiar to this was already implemented for vim in vimscript: image.vim, so you can consider this a modern, lua version.



With packer

use {
  requires = {

With vim.plug

Plug 'samodostal/image.nvim'
Plug 'nvim-lua/plenary.nvim'


-- Require and call setup function somewhere in your init.lua
require('image').setup {
  render = {
    min_padding = 5,
    show_label = true,
        show_image_dimensions = true,
    use_dither = true,
    foreground_color = false,
    background_color = false
  events = {
    update_on_nvim_resize = true,

Colors support:

Colors are turned off by default.

  • The reason for colors not being on by default is a significant delay when opening images + an additional dependency: plugin baleia.nvim (no need to call setup, only install)
  • Enable optionsrender.foreground_color and render.background_color
  • render.background_color setting is a nice addition that enables colors not only for characters, but also for the space behind them.