jarun/dotz

<h2 align="center"dotz - <iterminal image and video previewer in Braille art</i</h2

Render image and video previews as Braille art in the terminal with xterm-256 color and ncurses dim/normal/bold attributes.

It was written to be used as a terminal image viewer with nnn. Works independently too.

Features

• Braille art rendering for images
• Animated GIF support
• xterm-256 color and grayscale
• Dithering options (ordered, error diffusion)
• Video preview (frame extraction with ffmpeg)
• Video playback with seek controls

• File metadata panel
• Zoom in, zoom out, pan while zoom
• Rotate clockwise, flip horizontally
• Bounded background preloading
• Keyboard navigation and slideshow mode

<br <img width="1323" height="826" alt="image01" src="https://github.com/user-attachments/assets/f2becbbc-cfeb-42b3-bd92-3882ff3fb570" / <br<br <img width="1333" height="827" alt="image02" src="https://github.com/user-attachments/assets/62bc16a8-246b-4b5a-a11e-fd0faa5c8066" / <br<br <img width="1301" height="954" alt="image03" src="https://github.com/user-attachments/assets/609805be-c0c5-4815-bb33-3bc70d69c152" /

#### Supported formats

• Image: PNG, JPG, JPEG, BMP, GIF, TIFF, WEBP
• Video: MP4, MKV, AVI, MOV, WEBM, FLV, WMV, MPEG, MPG

Installation

Install from PyPI:

pip3 install dotz

Or install from the source repository:

# Install system dependencies (e.g., ffmpeg)
sudo apt-get install ffmpeg  # or use your OS package manager

# Install Python dependencies and the CLI tool
sudo pip3 install .

After installation, you can run the tool using:

dotz [options] <file-or-directory>

You can also run the tool directly from the source directory:

python3 dotz.py [options] <file-or-directory>