pdfreading-app 0.1.3

A PDF reader desktop app

Book-Reading-GUI-app

📖 Read da Book

A lightweight PDF reader desktop app built with Python and CustomTkinter. Supports adding PDFs from your local machine or directly from a URL, with lazy rendering for smooth performance on large documents.

---

Features

• 📂 Add PDFs from your local file system
• 🌐 Add PDFs directly from a URL
• 🔍 Zoom in and out while staying on the current page
• ⬅️ ➡️ Navigate pages with previous/next buttons or by typing a page number
• 💾 Automatically saves and restores your reading progress per book
• ⚡ Lazy rendering — only renders pages near the visible area for smooth scrolling on large documents
• 🗂️ Persistent library — your added PDFs are saved and restored on every startup

---

Installation

pip install pdfreading-app

Then launch it from anywhere with:

pdfreading-app

---

Requirements

• Python 3.9+
• Windows, macOS, or Linux

Dependencies are installed automatically:

• PyMuPDF — PDF rendering
• Pillow — image handling
• CustomTkinter — modern UI

Linux / macOS users: Tkinter does not come pre-installed on all systems. If you get a No module named 'tkinter' error, install it manually:

Ubuntu / Debian:

sudo apt install python3-tk

Fedora:

sudo dnf install python3-tkinter

macOS (Homebrew):

brew install python-tk

---

Run from source

# Clone the repo
git clone https://github.com/Vannphreak-Choup/Book-Reading-GUI-app.git
cd Book-Reading-GUI-app

# Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate        # Windows
source .venv/bin/activate     # macOS / Linux

# Install in editable mode
pip install -e .

# Run
python -m pdfreading.main

---

Project Structure

src/
└── pdfreading/
    ├── main.py              # entry point
    ├── assets/              # icons and images
    ├── openDialog/          # file and URL dialogs
    │   ├── AddFile.py
    │   └── Addurl.py
    └── utils/
    |   ├── Data.py          # shared app state
    |   ├── UI.py            # UI layout
    |   └── functionality.py # core logic
    └── main.py

---

License

MIT