An open API service indexing awesome lists of open source software.

https://github.com/tpc-pascal/digital-library

Digital place to store all of my e-books/pdfs/resources
https://github.com/tpc-pascal/digital-library

books digital library pdfs resources

Last synced: 27 days ago
JSON representation

Digital place to store all of my e-books/pdfs/resources

Awesome Lists containing this project

README

          

# 📚 Digital Library

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/tpc-pascal/digital-library/blob/main/colab.ipynb)
[![Open in Hugging Face](https://huggingface.co/datasets/huggingface/badges/resolve/main/open-in-hf-spaces-md-dark.svg)](https://huggingface.co/spaces/tpc-pascal/digital-library)

> Kệ sách ảo cá nhân để lưu trữ, duyệt và đọc PDF tài liệu.

**Lý do ra đời:** Bạn có quá nhiều PDF rải rác khắp nơi và muốn một nơi gọn gàng để đọc? Công cụ này giúp bạn có một kệ sách ảo đẹp mắt với trình đọc PDF tích hợp, hỗ trợ toàn màn hình và điều hướng bằng bàn phím.

---

## Tính năng

- Kệ sách ảo với hiệu ứng gỗ, hover và cuộn ngang
- Trình đọc PDF tích hợp (dùng PyMuPDF), lật trang bằng phím mũi tên ← →
- Hỗ trợ ảnh bìa tự động từ file PNG/JPG trùng tên
- Chế độ toàn màn hình
- Chạy trên local, Hugging Face Spaces và Google Colab

---

## Cấu trúc thư mục

```
digital-library/
├── hf/ # Hugging Face Spaces deployment
│ ├── app.py # Entry point — Gradio UI
│ ├── requirements.txt # Python dependencies (pymupdf)
│ └── README.md # HF Space metadata
├── books/ # PDF files
├── images/ # Cover images
├── .github/workflows/
│ ├── sync.yml # Đồng bộ lên HF Spaces
│ └── wake.yml # Cron giữ thức
├── colab.ipynb # Google Colab notebook
├── CONTRIBUTING.md # Hướng dẫn đóng góp
├── CREDITS.md # Credits & tham khảo
└── LICENSE # MIT
```

---

## Tech Stack

| Layer | Công nghệ |
|---|---|
| Language | Python 3.13 |
| Web UI | Gradio 6.14 |
| PDF Engine | PyMuPDF (fitz) |
| Hosting | Hugging Face Spaces |
| CI/CD | GitHub Actions |

---

## Tác giả

**tpc-pascal** — [GitHub](https://github.com/tpc-pascal)

---

## License

MIT — xem file [LICENSE](./LICENSE).