Images in the terminal
Clone this wiki locally
I get a lot of comments/questions about how to get w3m-img mode working with
neofetch. This wiki page will guide you through setting up neofetch/w3m-img and
will try to explain the various quirks of this mode.
Enabling Image Mode
Neofetch 2.0.1 changes the default image mode to
wallpaper. From 2.0.1 onwards an additional step is required to use image mode.
You can either use the launch option
--image wallpaper (also
/path/to/dir/) or you can edit the config file to enable image mode. The option you have to change is called
image_source, just change this from
ascii to one of the other valid values and image mode will be enabled.
- Image rendering in the terminal.
- This is sometimes bundled together with
iTermusers don't need to install w3m-img.
- Generating thumbnails and cropping the images.
A terminal emulator that supports
xwininfo + xpropor
xwininfo + xdpyinfo
- Getting the terminal window size in pixels so that we can size the image correctly.
The table below lists my testing of various terminal emulators, what works and
|Gnome-terminal||Yes||- Image disappears on window focus and resize
- Possible issues on Fedora, see #295
|st||Yes||Image disappears on window focus and resize|
|Terminator||Yes||Image disappears on window focus and resize|
 iTerm doesn't require
w3m-img to display images. Instead it uses a
set of escape sequences built into iTerm.
 Terminology doesn't require
w3m-img to display images. Instead it uses
a builtin program called
Note: For image mode to work, the
w3m-img column must say
yes and you must have
the dependencies installed.
Neofetch by default will try to use your current wallpaper as the image. If the
wallpaper detection fails we fallback to ascii mode, when ths happens you should
try and launch neofetch with
--image path/to/image or
The list below shows the current wallpaper setters we support.
Linux / BSD
Mac OS X / Windows
- Builtin wallpaper setter
If your wallpaper setter isn't listed here and there's an easy way to find where
the current wallpaper is stored, open an issue and I'll gladly add support for it.
Once you've installed
imagemagick, have a terminal emulator that
meets the criteria above and have a working image source, neofetch should
display images correctly.
If neofetch still won't display the images then you should open a new issue on
github and provide me with a verbose log.