122 lines
3.9 KiB
Markdown
122 lines
3.9 KiB
Markdown
# I Hate PDFs
|
|
|
|
I Hate PDFs is an open-source macOS PDF reader for anyone who hates adobe. I think adobe is .
|
|
|
|
## Status
|
|
|
|
This app is entirely vibe coded, but will somehow still be better than adobe acrobate soon.
|
|
|
|
Minimum supported macOS version: macOS 13 Ventura.
|
|
|
|
Supported Mac architectures: Apple Silicon and Intel, subject to the local Swift/Xcode toolchain used to build.
|
|
|
|
## Features
|
|
|
|
- Open local `.pdf` files from disk.
|
|
- Read with smooth PDFKit scrolling, Retina rendering, zoom, fit-to-width, fit-to-page, and page navigation.
|
|
- Search selectable text PDFs from a compact toolbar control.
|
|
- Start in a focused single-pane reading layout, with thumbnail and comments sidebars hidden until requested.
|
|
- Remember thumbnail and comments sidebar visibility per PDF and coarse window size.
|
|
- Toggle a compact page thumbnail/sidebar inspector.
|
|
- Create selection-bound comments from highlighted PDF text.
|
|
- Create highlight annotations with anchored optional comments.
|
|
- Create underline annotations with optional comments.
|
|
- Create free-text annotations directly on the page.
|
|
- Click annotations in the PDF to reopen and edit the comment in place.
|
|
- Save annotations directly into the original PDF after an overwrite warning.
|
|
- Save As a new annotated copy.
|
|
- Share the annotated PDF through the native macOS share picker.
|
|
- Review annotations in a compact list with page number, type, author, date, and first comment line.
|
|
- Use an Acrobat-style comments sidebar with total count, page grouping, collapsible groups, an add-comment affordance, comment search, collapsed type/author/status filters, full text, replies, edit/delete, and click-to-navigate.
|
|
|
|
## Build From Source
|
|
|
|
Requirements:
|
|
|
|
- macOS 13 or newer
|
|
- Xcode 15 or newer with command line tools
|
|
- Swift Package Manager
|
|
|
|
Build and run the debug executable:
|
|
|
|
```sh
|
|
swift run IHatePDFs
|
|
```
|
|
|
|
Run tests:
|
|
|
|
```sh
|
|
swift test
|
|
```
|
|
|
|
Build a release `.app` bundle:
|
|
|
|
```sh
|
|
scripts/build-app.sh
|
|
```
|
|
|
|
Release app builds default to a universal `arm64` + `x86_64` executable. To build only the current architecture during development, run:
|
|
|
|
```sh
|
|
ARCHS="" scripts/build-app.sh
|
|
```
|
|
|
|
Create a downloadable `.dmg`:
|
|
|
|
```sh
|
|
scripts/make-dmg.sh
|
|
```
|
|
|
|
The packaged app is written to `dist/I Hate PDFs.app`; the disk image is written to `dist/IHatePDFs.dmg`.
|
|
|
|
## Installation
|
|
|
|
Download `IHatePDFs.dmg`, open it, and move `I Hate PDFs.app` into `/Applications`. For local development builds that are not notarized, macOS may require opening the app from Finder with Control-click, Open the first time.
|
|
|
|
## Development
|
|
|
|
The project is a Swift Package with two targets:
|
|
|
|
- `IHatePDFsCore`: PDF annotation models and factory helpers.
|
|
- `IHatePDFs`: SwiftUI macOS app, PDFKit bridge, toolbar, menus, sidebars, anchored comment popovers, opening, saving, sharing, and search.
|
|
|
|
Useful checks:
|
|
|
|
```sh
|
|
swift test
|
|
swift build -c release
|
|
swift scripts/verify-sample-pdf.swift
|
|
swift scripts/verify-pdf-annotations.swift
|
|
```
|
|
|
|
The PDF verification scripts generate and inspect standard highlight, underline, selected-text comment, reply, free-text, and popup annotation dictionaries.
|
|
|
|
Manual release QA for Preview, Acrobat Reader, and browser PDF viewers is documented in `docs/QA.md`. The macOS design review is documented in `docs/DESIGN_REVIEW.md`.
|
|
|
|
## Screenshots
|
|
|
|
Screenshots live in `docs/screenshots`.
|
|
|
|
Current repository screenshots:
|
|
|
|
- `docs/screenshots/no-document.png`
|
|
- `docs/screenshots/default-reading.png`
|
|
- `docs/screenshots/highlight-comment-popover.png`
|
|
- `docs/screenshots/main-window.png`
|
|
- `docs/screenshots/comments-sidebar.png`
|
|
- `docs/screenshots/dark-mode-reading.png`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
MIT. See `LICENSE`.
|