https://github.com/ckardaris/ucollage

An extensible command line image viewer inspired by vim
https://github.com/ckardaris/ucollage

cli command image keyboard line ueberzug viewer vim

Last synced: 2 months ago
JSON representation

An extensible command line image viewer inspired by vim

• Host: GitHub
• URL: https://github.com/ckardaris/ucollage
• Owner: ckardaris
• License: gpl-3.0
• Created: 2020-10-04T07:02:23.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-11-07T18:32:52.000Z (3 months ago)
• Last Synced: 2024-11-07T19:35:17.266Z (3 months ago)
• Topics: cli, command, image, keyboard, line, ueberzug, viewer, vim
• Language: Shell
• Homepage:
• Size: 25.6 MB
• Stars: 210
• Watchers: 4
• Forks: 3
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ucollage

An extensible command line image viewer inspired by vim.



  

  

  





 

 

 

 





  

  





  

  

  



![](https://i.imgur.com/zWyhZXB.png)

## 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](https://ucollage.readthedocs.io/en/stable/install.html) to

  install `ucollage`.

- Type

  ```bash

  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](https://ucollage.readthedocs.io/en/stable) 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