# viewer

<img src="img/viewer.svg" align="left" width="150" height="150">

![Version](https://img.shields.io/badge/version-0.1.3-blue) ![Rust](https://img.shields.io/badge/language-Rust-f74c00) ![License](https://img.shields.io/badge/license-Unlicense-green) ![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS-blue) ![Stay Amazing](https://img.shields.io/badge/Stay-Amazing-important)

A universal read-only file viewer for the terminal. Point it at almost any file
— spreadsheet, document, slide deck, PDF, image, code — and it renders a clean
preview, then launches the right editor on a keypress. Part of the
[Fe2O3](https://github.com/isene/fe2o3) Rust terminal suite.

<br clear="left"/>

## The idea

One viewer for everything LibreOffice-shaped, plus text, code and images. It
detects the file type and renders it read-only with the right method — calamine
for tables, pandoc for documents, pdftotext for PDFs, syntax highlighting for
code, inline images via kitty/sixel — then hands off to an editor when you want
to change something. Formats live in a small config table, so adding one is a
line, not a recompile.

## Screenshots

![viewer — spreadsheet table](img/screenshot-table.png)
![viewer — syntax-highlighted code](img/screenshot-code.png)
![viewer — slide deck](img/screenshot-slides.png)
![viewer — inline image](img/screenshot-image.png)

## Features

- **Tables** — csv/tsv, xlsx/ods (calamine); aligned columns, Excel dates as
  `YYYY-MM-DD`.
- **Documents** — docx/odt via pandoc.
- **Slides** — pptx/odp text outline with per-slide dividers.
- **PDF** — pdftotext.
- **Images** — rendered **inline** via [glow](https://github.com/isene/glow)
  (kitty / sixel).
- **Code & text** — syntax-highlighted with
  [highlight](https://github.com/isene/highlight) (18 languages plus Markdown,
  HyperList, LaTeX).
- **Launches the right editor** — `e` opens grid / scribe / `$EDITOR` per type;
  `x` opens with the system default (xdg-open).
- **AI editing** — `Ctrl+A` opens an integrated
  [Claude Code](https://claude.com/claude-code) session seeded with the file; the
  matching skill (pptx / docx / xlsx / pdf) edits it in place, preserving layout.
  For slide decks it keeps a **live PDF preview** in sync: Claude re-renders
  with `slidepreview` after each change, and a single zathura window
  (opened once, placed wherever you like) auto-reloads it.
- **Browse** — `o` (or launching with no file) opens
  [pointer](https://github.com/isene/pointer) as the file picker.
- Config-driven and extensible via `~/.config/viewer/handlers.conf`.

## Install

```bash
# From a release (Linux/macOS, x86_64/aarch64)
chmod +x viewer-* && sudo cp viewer-linux-x86_64 /usr/local/bin/viewer

# Or build from source (needs the sibling crust/glow/highlight crates alongside)
for r in crust glow highlight viewer; do git clone https://github.com/isene/$r; done
cd viewer && cargo build --release
```

## Usage

```bash
viewer report.docx
viewer data.xlsx
viewer photo.png
viewer              # no file → browse with pointer
```

## Keys

| Key | Action |
|-----|--------|
| `j k` / arrows | scroll |
| `g` `G` | top / bottom |
| `PgUp` `PgDn` | page |
| `e` `Enter` | edit — launch the right editor (slide decks open the Claude session) |
| `Ctrl+A` | edit with Claude — full session (uses the file-type skill) |
| `x` | open externally (xdg-open) |
| `o` | browse files (pointer) |
| `?` | help |
| `q` | quit |

## Configuring formats

`~/.config/viewer/handlers.conf` — one line per extension:

```
# ext   kind    edit-command
pptx    slides  -
epub    doc     scribe
ini     text    $EDITOR
```

`kind` is one of `table` / `text` / `doc` / `slides` / `pdf` / `image` / `hex`;
`-` means view-only; the edit-command can be `xdg-open` to defer to the system
default.

## Part of Fe2O3

viewer is one tool in the [Fe2O3](https://github.com/isene/fe2o3) suite of fast
Rust terminal apps. It builds on [crust](https://github.com/isene/crust),
[glow](https://github.com/isene/glow) and
[highlight](https://github.com/isene/highlight), launches
[grid](https://github.com/isene/grid) for spreadsheets, and uses
[pointer](https://github.com/isene/pointer) to browse.

## License

Public domain ([Unlicense](https://unlicense.org)).