Skip to content

An extensible command line image viewer inspired by vim

License

Notifications You must be signed in to change notification settings

ckardaris/ucollage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ucollage

An extensible command line image viewer inspired by vim.

GitHub contributors GitHub release License

GitHub watchers GitHub Repo stars GitHub issues GitHub pull requests

GitHub last commit (master) Read the Docs (stable)

GitHub last commit (dev) GitHub commits since last release Read the Docs (latest)

Features

  • view images and video thumbnails
  • renaming
  • moving to Trash
  • rating
  • categories
  • editing images supporting undo and redo actions
  • fully customizable vim keybindings
  • command execution

Getting Started

  • Follow the instructions to install ucollage.
  • Type
    ucollage
    in a directory with images.
  • Use hjkl or arrows in order to select different images, Enter to view an image in monocle mode and Backspace to go back in the grid. n fetches the next batch of images and p the previous one.

Documentation

Viewing the images is half the fun. Read the documentation in order to explore the more interesting functionalities that are possible with ucollage.

Contributing

I will gladly accept contributions from any interested parties. I would prefer most contributions to be targeted towards improving the language of the documentation, in order for it to be more understandable for the new user of the software.

"It's hard to explain the internal quirks of a system, when you are the creator of such a monster." --Myself