Dumb image viewer
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Arthur Williams c393a272ce Update links to point to codeberg 3 months ago
samples Added support for user bindings 11 months ago
Makefile Allow the default image loader to be compiled out 10 months ago
README.md Update links to point to codeberg 3 months ago
arg_parse.c Added help and version flags 7 months ago
defaults.c Fix incorrect horizontal panning keybindings 3 months ago
div.c Updated documentation and added missing helper methods 3 months ago
div.h Updated documentation and added missing helper methods 3 months ago
div.sh.template Support invoking user specified makefile instead of compilier directly 11 months ago
functions.c Cache scaled image 3 months ago
functions.h Implement imaging panning 9 months ago
image_view.c By default compile with c99 10 months ago
image_view.h Allow default scaling function to be overriden 10 months ago
x.c Reduce memory usage when zooming 3 months ago
x.h Sort imports 9 months ago


Dumb Image Viewer

It can view images... it can also do more, but you'll have to tell it to. Think of it as a library to create your own image view that happens to have useable defaults.


make install

The following are the dependant libs -lxcb -lxcb-keysyms -lxcb-icccm -lxcb-image -limgloader Note that libimageloader is just a wrapper around other image loaders and can be replaced easily if desired.


  1. Create ~/.config/dim/config.c
  2. Create a array called user_bindings of type Binding. Also define a method with signature of void onStartup(){} see [samples/no_op.c] for an example
  3. Run div --recompile to recompile (run after every change to config.c)
  4. div to actually launch

user_bindings will be used to for any custom bindings you may want. These will be processed before the default bindings and replace them if they conflict. onStartup will be called on startup and can be used to do whatever you want.


This project was born from frustrations with the development of nxiv. The goal of this project is to have a simple, minimal image viewer that can easily be extended to any arbitrary usecase. So minimalism and extensibility are the main points of focus.


In line with the goal,

  1. Anything should be possible via user config files. Relatedly all default behavior is controlled by defaults.c which is basically a default config file.
  2. Some useful functionality that can be done from the config file may be merged to either defaults.c or to functions.c. This is to just prevent duplication work
  3. If your usecase can be achieved easier through patching than the config file (this includes use of external tools), consider sending a PR for a new flag
  4. Write functions in a modular way so people can reuse pieces of code


  1. Custom keybindings
  2. Grid view: see RC images in a RxC grid (which is a generalization of a dual page view)
  3. View images left-to-right or right-to-left
  4. Zooming and (basic) scaling
  5. Panning across images
  6. Under 1000 lines of code. Only other image I'm aware of that is comparable is lel and meh both of which are far less customizable.
  7. Modular design would make it easy to swap out X11/imlib backends
  8. Ability to load from zip files, directories, pipes and urls thanks to the flexible backend
  9. Can react to any arbitrary X events

Things (trivially) possible from config file

  1. Mouse bindings and key release
  2. Spawning external commands
  3. Reloading image of disk change (ie via inotify)
  4. Loading args from the environment or config file
  5. Custom cli options


  • Consider adding example configs
  • Be consistent with variable naming


The image is distorted/ The image is distorted while zooming

Change the scaling function. By default a really cheap, fast scaling function is used but it doesn't produce the best images. You can roll your own or use a 3rd party one. I recommend stb_image_resize.h. Another option is to just disable zooming (state.zoom=1) and/or disable scaling (state.scale_mode=SCALE_NORMAL) which will just use the raw image.