Metadata-Version: 2.4
Name: ercomp
Version: 0.13.0
Summary: Terminal media browser — thumbnail TUI for images and video (Pillow + bundled ffmpeg).
Author-email: ErCo <ercancoruh@ercancoruh.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/ercancoruh/ercomp
Project-URL: Repository, https://github.com/ercancoruh/ercomp
Project-URL: Issues, https://github.com/ercancoruh/ercomp/issues
Keywords: terminal,media,player,image,video,viewer,cli,ffmpeg,truecolor
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Terminals
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=10.0.0
Requires-Dist: imageio-ffmpeg>=0.5.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Dynamic: license-file

# ercomp

Terminal media **browser** — thumbnail grid in your current folder.
Photos and videos open in **new windows**; the browser stays open.

```bash
pip install ercomp
ercomp
```

On Windows, `pip install` also tries to fetch a portable **mpv** build (GPU video).
You can also run `ercomp setup-mpv` or `winget install shinchiro.mpv`.

## Controls (browser)

| Key | Action |
|-----|--------|
| Arrows | Move |
| Enter | Open folder / open file in a new window |
| Backspace / `h` | Parent folder |
| `r` | Refresh |
| `q` | Quit |

## Controls (photo / terminal video window)

| Key | Action |
|-----|--------|
| Backspace / `q` / Esc | Close window |
| `+/-` | Zoom (photos) |
| Arrows | Pan / seek |

## Optional

```bash
ercomp doctor
ercomp setup-mpv
ercomp init-config
```

## Config

`~/.config/ercomp/config.toml`:

```toml
video_backend = "auto"   # auto | terminal | mpv
video_graphics = "blocks"
cell_budget = 10000
mouse = true
```

## Development

```bash
pip install -e ".[dev]"
pytest -q
```

## License

MIT © ErCo — see [LICENSE](LICENSE) and [CHANGELOG](CHANGELOG.md).
