<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 dotzOr 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>