Metadata-Version: 2.1
Name: sview
Version: 0.2.0
Summary: Sequence-aware filesystem browser
Project-URL: Repository, https://github.com/rsgalloway/sview
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: PySide6>=6.6
Requires-Dist: pyseq
Provides-Extra: dev

# sview

`sview` is a sequence-aware filesystem browser built with PySide6 and `pyseq`.
It provides a sequence-first view of directories so image sequences can be
browsed as logical units instead of individual files.

![sview screenshot](sview.png)

## Install

```bash
pip install -U sview
```

## Run

Launch the app:

```bash
sview
```

Open a specific folder:

```bash
sview /mnt/projects/
```

Print the version:

```bash
sview --version
```

Run with scanner debug output in the terminal:

```bash
sview --debug
```

## Configuration

On first launch, `sview` writes a user config file to:

```bash
~/.config/sview/config.json
```

It also stores lightweight UI state in:

```bash
~/.config/sview/ui_state.json
```

This file controls default file and sequence handlers, including custom
commands for double-click actions.

It also contains scanner worker safety settings such as process priority and
memory limit:

```json
{
  "scanner": {
    "worker": {
      "nice_increment": 15,
      "memory_limit_mb": null,
      "timeout_seconds": 30
    }
  }
}
```

`memory_limit_mb` is opt-in. Leave it as `null` unless you specifically want a hard
address-space cap on the worker process.
