Metadata-Version: 2.4
Name: neoview
Version: 0.1.5
Summary: NeoView PDF viewer with rectangular crop/measure tool
Author: NeoView Contributors
License-Expression: MIT
Project-URL: Repository, https://github.com/Srikanth-Mohankumar/neoview
Project-URL: Issues, https://github.com/Srikanth-Mohankumar/neoview/issues
Keywords: pdf,viewer,measurement,crop,pymupdf,pyside6
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6
Requires-Dist: PyMuPDF
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Requires-Dist: ruff>=0.3.0; extra == "dev"
Requires-Dist: build>=1.0.3; extra == "dev"
Requires-Dist: pyinstaller>=6.0; extra == "dev"
Dynamic: license-file

# NeoView

NeoView is a production-quality PDF viewer with a rectangular crop/measure tool for Linux and Windows.

NeoView is designed as a practical alternative to SumatraPDF for Linux users, while adding features useful for technical and LaTeX workflows.
Key advantages:
- **Auto-reload**: automatically refreshes PDFs when LaTeX rebuilds, so you don't have to close/reopen the viewer.
- **Measurement tools**: precise rectangle measurement with units in pt/mm for layout and proofreading.
- **Export selections**: save regions as PNG at multiple DPI values.

## Features

- **PDF Viewing**: Open and navigate multi-page PDFs
- **Zoom**: Pinch gestures, Ctrl+wheel, Fit Width, Actual Size
- **Selection Tool**: Click+drag to create measurement rectangle
- **Precise Adjustment**: Drag edges/corners to resize, keyboard nudges
- **Measurements**: Live display in points, picas, and millimeters
- **Export**: Save selection as PNG at 150/300/600 DPI
- **Auto-reload**: Watch file for external changes
- **Container-ready**: Works with Wayland or X11 forwarding

## Requirements

- Python 3.10+
- PySide6
- PyMuPDF

## Installation

```bash
pip install neoview
```

## Downloads

Prebuilt Windows executable releases are available from the GitHub Releases page for this project.
Each tagged release will include a `neoview.exe` download.

### Install from source (launchable)

```bash
pip install .
```

This installs a `neoview` launcher. Run it to open the app, then use File → Open to choose a PDF.

Optional desktop launcher (Linux):

```bash
./install_desktop.sh
```

### Windows notes

If you run on Windows, install with:
```powershell
py -m pip install neoview
```

Launch:
```powershell
neoview
```

### Windows .exe build (optional)

If you want a standalone executable on Windows:

```powershell
py -m pip install .[dev]
pyinstaller neoview.spec
```

The executable will be at `dist\\neoview.exe`.

## Usage

### Direct Run

```bash
# Open with file dialog
python pdf_crop_measure.py

# Open specific PDF
python pdf_crop_measure.py /path/to/document.pdf
```

### Installed App

```bash
# Open the app
neoview

# Open specific PDF
neoview /path/to/document.pdf
```

### Module Run

```bash
python -m neoview
```

### Container Run

**Build:**
```bash
docker build -t pdf-measure .
```

**Wayland (GNOME Wayland - preferred):**
```bash
docker run -it --rm \
  -e XDG_RUNTIME_DIR=/run/user/$(id -u) \
  -e WAYLAND_DISPLAY=$WAYLAND_DISPLAY \
  -e QT_QPA_PLATFORM=wayland \
  -v $XDG_RUNTIME_DIR/$WAYLAND_DISPLAY:/run/user/$(id -u)/$WAYLAND_DISPLAY \
  -v /path/to/pdfs:/pdfs \
  pdf-measure /pdfs/document.pdf
```

**X11 (fallback, most compatible):**
```bash
xhost +local:docker
docker run -it --rm \
  -e DISPLAY=$DISPLAY \
  -e QT_QPA_PLATFORM=xcb \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v /path/to/pdfs:/pdfs \
  pdf-measure /pdfs/document.pdf
```

## Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| `Ctrl+O` | Open PDF file |
| `Ctrl+Q` | Exit application |
| `Ctrl+C` | Copy measurements to clipboard |
| `Ctrl+S` | Export selection as PNG |
| `PgUp` / `PgDn` | Previous / Next page |
| `Ctrl+Wheel` | Zoom in/out |
| `W` | Fit to width |
| `1` | Actual size (100%) |
| `Arrow` | Move selection by 1 pt |
| `Shift+Arrow` | Move selection by 10 pt |
| `Ctrl+Arrow` | Resize selection by 1 pt |
| `Ctrl+Shift+Arrow` | Resize selection by 10 pt |
| `Escape` | Clear selection |

## Selection Tool

1. **Create**: Click and drag on the PDF page
2. **Move**: Drag inside the selection
3. **Resize**: Drag edges or corners
4. **Fine-tune**: Use arrow keys with modifiers
5. **Measure**: See live measurements in status bar

All measurements are in PDF coordinate space (points) and remain accurate at any zoom level.

## Export

1. Create a selection
2. Press `Ctrl+S` or click Export button
3. Choose DPI (150/300/600)
4. Save as PNG

## Auto-reload

Enable "Auto-reload on file change" in Options menu to automatically refresh when the PDF is modified externally. Selection and page position are preserved.

## License

MIT

## Development

```bash
python3 -m pip install -e .[dev]
pytest
```
