dubey/tview
dubey/tview
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
A (relatively) fast, lightweight, and useful image viewer.
41 Commits 3 Branches 0 Tags 4.4 MiB
C++ 76.8%
C 23.2%
main
Go to file
Tanishq Dubey 8daae426e6
All checks were successful
Run Build / run-build-ubuntu (push) Successful in 2m12s
Details
Run Build / run-build-debian (push) Successful in 2m13s
Details
Run Build / run-build-arch (push) Successful in 2m20s
Details
tooltip screenshot
2024-06-16 17:26:21 -04:00
.gitea/workflows remove duplicate debian 2024-06-16 16:34:48 -04:00
lib histogram works, we are basically at a 0.9 release 2024-06-16 09:51:21 -04:00
screenshots new readme 2024-06-16 17:18:35 -04:00
.gitignore switch to cmake 2024-06-16 10:23:53 -04:00
CMakeLists.txt add debian build and build optimization 2024-06-16 16:30:59 -04:00
main.cpp try exiv version fix for ubuntu 2024-06-16 11:30:22 -04:00
README.md tooltip screenshot 2024-06-16 17:26:21 -04:00

README.md

tview

A (relatively) fast, lightweight, and useful image viewer.

Main Image

Features

  • Supports most common image formats
  • EXIF Viewing
  • Histogram Calculation
  • Toggle image filtering
  • Pixel level details
  • Color tooltip

Gallery

Tooltip

Toggle the tooltip by pressing t Tooltip

Detail Views

Toggle detail modes by pressing d

Normal Arrow Hex Color RGB 255 Color RGB Float Color
Normal Arrow Hex RGB 255 RGB Float

Image Filtering

Toggle Filtering by pressing

Filtering Off Filtering On
Filtering Off Filtering On

Usage

tview PATH/TO/IMAGE

Press h to show the help dialog within the program.

Mouse

Scroll to zoom. Click and drag to pan.

Keyboard

  • h - Show help
  • c- Toggle Histogram
  • e- Toggle EXIF data
  • d- Cycle #Detail Views (default off)
  • a - Toggle image filtering (default off)
  • g - Toggle grid (only visible at pixel level)
  • r- Rotate image 90 degrees clockwise
  • q - Quit

Installing

Requirements to Run

  • SDL2
  • OpenGL
  • Libexiv2

Requirements to build

In addition to the run requirements

  • CMake
  • C++ Compiler (g++/clang++)

On Ubuntu

apt install --no-install-recommends build-essential cmake libsdl2-dev libexiv2-dev mesa-utils

On Debian

apt install --no-install-recommends build-essential cmake libsdl2-dev libexiv2-dev mesa-utils

On Arch

pacman -Sy sdl2 mesa-utils exiv2 cmake base-devel

Building

Clone the repository

git clone https://git.dws.rip/dubey/tview.git

Change directory into the repository

cd tview

Generate build files and trigger build

cmake .
cmake --build .

You will now have a file called tview in the repository root, you can copy this into your path:

sudo mv ./tview /usr/local/bin/tview

tview is now installed on your system