8000 GitHub - benzanol/vim-imager: Display real images (not just ascii) inside of vim using Üeberzug
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Display real images (not just ascii) inside of vim using Üeberzug

License

Notifications You must be signed in to change notification settings

benzanol/vim-imager

8000

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vim Imager

Display real images (not just ascii) inside of vim using Überzug This plugin will only work in terminal vim/neovim and while running X11.

For more information about Überzug check out the github page:
https://github.com/seebye/ueberzug

Installation

Installing Überzug

Make sure that python3 is installed, and run the following command:
pip3 install ueberzug

Install with Vim Plug

< 73B8 /a>

Add the following to your vimrc
Plug 'qaiviq/vim-imager'

Then reload vim and run the command PlugInstall

Add the following to your vimrc
Plugin 'qaiviq/vim-imager'

Then reload vim and run the command PluginInstall

Inserting an Image

Imager will insert an image wherever you place the following text in your file:
<<img path="PATH-TO-IMAGE" height=HEIGHT-IN-LINES>>

For example, to insert the image ~/Pictures/MyImage 5 lines high, you would use:
<<img path="~/Pictures/MyImage" height=5>>

You can also specify a path relative to the file you are inserting the image into. If the image you wanted to insert was in the same directory as the file, you could use:
<<img path="MyImage" height=5>>
or alternatively
<<img path="./MyImage" height=5>>

If the image was in the directory above the current file, its relative path would be:
<<img path="../MyImage" height=5>>

This dot pattern continues, meaning that for each higher up directory, simply add another dot. If you wanted to acces the image ~/MyImage from the file ~/Documents/Misc/Notes/MyNote.txt, the relative path would be:
<<img path="..../MyImage" height=5>>

If you wanted to insert images into code, any string of characters can be inserted before or after the image declaration to make it a comment, and it will still work.
# <<img path="MyImage" height=5>>
// <<img path="MyImage" height=5>>
<!--<<img path="MyImage" height=5>>-->

Configuration

Specify a list of filetypes to enable imager in:
let g:imager#filetypes = ['.md']

Enable imager automatically for all files:
let g:imager#all_filetypes = 1

Disable imager temporarily (for example, to edit the displayed images)
:DisableImages

Enable imager if it is disabled
:EnableImages

Toggle imager being enabled or disabled
:ToggleImages

Forcibly reload all displayed images
:ReloadImages

Screenshots

With imager disabled

imager-off-screenshot

With imager enabled

imager-on-screenshot

About

Display real images (not just ascii) inside of vim using Üeberzug

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
0