# booru-viewer

Local desktop application for browsing, searching, and favoriting images from booru-style imageboards.

## Features

- Supports Danbooru, Gelbooru, Moebooru, and e621
- Auto-detect site API type — just paste the URL
- Tag search with autocomplete and history
- Thumbnail grid with image/video preview (zoom, pan, GIF animation)
- Favorites with folder organization
- Save to library, drag-and-drop, multi-select bulk operations
- Custom CSS theming (native OS look by default)
- Cross-platform: Linux and Windows

## Install

```sh
pip install -e .
```

### Dependencies

- Python 3.11+
- PySide6 (Qt6)
- httpx
- Pillow

## Usage

```sh
booru-viewer
```

Or run directly:

```sh
python -m booru_viewer.main_gui
```

### Windows

Download `booru-viewer.exe` from [Releases](https://git.pax.moe/pax/booru-viewer/releases).

For WebM video playback, install **VP9 Video Extensions** from the Microsoft Store.

### Keybinds

| Key | Action |
|-----|--------|
| Click / Arrow keys | Select and preview |
| `h`/`j`/`k`/`l` | Grid navigation |
| `Ctrl+A` | Select all |
| `Ctrl+Click` / `Shift+Click` | Multi-select |
| Scroll wheel | Zoom in preview |
| Middle click | Reset view |
| Left / Right | Previous / next post |
| `Ctrl+P` | Privacy screen |
| `F11` | Fullscreen |
| Right click | Context menu |

## Adding Sites

File > Manage Sites. Enter a URL, click Auto-Detect, and save.

API credentials are optional — needed for Gelbooru and rate-limited sites.

## Theming

The app uses your OS native theme by default. To customize, create `custom.qss` in your data directory:

- **Linux**: `~/.local/share/booru-viewer/custom.qss`
- **Windows**: `%APPDATA%\booru-viewer\custom.qss`

A green-on-black theme template is available in Settings > Theme > Create from Template.

## Data Locations

| | Linux | Windows |
|--|-------|---------|
| Database | `~/.local/share/booru-viewer/booru.db` | `%APPDATA%\booru-viewer\booru.db` |
| Cache | `~/.local/share/booru-viewer/cache/` | `%APPDATA%\booru-viewer\cache\` |
| Library | `~/.local/share/booru-viewer/saved/` | `%APPDATA%\booru-viewer\saved\` |

## License

MIT