Metadata-Version: 2.3
Name: blessedviewer
Version: 0.1.0
Summary: A blessed terminal-based image viewer
Author: Ashkan Feyzollahi
Author-email: ashkanfeyzollahi@gmail.com
Requires-Python: >=3.13
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: blessed (>=1.21.0,<2.0.0)
Requires-Dist: click (>=8.2.1,<9.0.0)
Requires-Dist: numpy (>=2.3.3,<3.0.0)
Requires-Dist: pillow (>=11.3.0,<12.0.0)
Description-Content-Type: text/markdown

# Blessed Viewer

![screencast](screencast.gif)

<p align="center">
    <em>🖼️ A blessed terminal-based image viewer</em>
</p>

**blessedviewer** is a simple terminal-based image viewer made for people who wanna view their images at terminal. The name of this project starts with **blessed** because this project uses **blessed** for moving cursor and printing colors. And if you wanna know how this project decodes images? just know that it uses **pillow**. This project was made for fun purposes.

> [!WARNING]
> This project uses 24-bit terminal colors which may not be supported on old systems

## Usage

## Installation

1. **[Install Pipx](https://gist.github.com/ashkanfeyzollahi/7bbf36fb876a3781efbbb3ef841b5f4e)** (if you don't have it already)

2. **Install `blessedviewer` using Pipx**:

```bash
pipx install blessedviewer
```

## Usage

```plain
Usage: blessedviewer [OPTIONS] FILENAME

  A blessed terminal-based image viewer

Options:
  --help  Show this message and exit.
```

