✨ Features

🎬 Demo

🌐 Live Demo →

Note: The demo runs entirely in your browser. Add some ebooks to try it out!

🚀 Installation

git clone https://github.com/Programming2055/Booky.git
cd Booky
npm install
npm start

Windows Users: Double-click start.bat to launch!

📸 Screenshots

📖 Usage

1. Click the + Add Book button in the header
2. Select your ebook files (PDF, EPUB, MOBI, etc.)
3. Books are automatically added with cover extraction

Reading Books

• Click any book cover to open in the built-in reader
• Use arrow keys or click edges to navigate pages
• Press Escape to close the reader

Organizing Collections

1. Click + New Collection in the sidebar
2. Drag and drop books into collections
3. Right-click collections to rename or delete

Using PDF Tools

1. Open any PDF in the reader
2. Click the 🔧 Tools button in the toolbar
3. Select a tool (requires Stirling-PDF)

⌨️ Keyboard Shortcuts

Note: PDF reader uses the standard Mozilla pdf.js viewer which has its own toolbar and keyboard shortcuts.

📋 Format Support

🔧 PDF Tools Setup

Booky integrates with Stirling-PDF for advanced PDF operations.

Using Docker (Recommended)

docker run -d -p 8080:8080 --name stirling-pdf frooodle/s-pdf:latest

Using Docker Compose

services:
  stirling-pdf:
    image: frooodle/s-pdf:latest
    ports:
      - "8080:8080"
    restart: unless-stopped

Once running, the 🔧 Tools button in the PDF reader will be active!

🏗️ Tech Stack

📁 Project Structure

booky/
├── 📂 public/
│   ├── 📂 foliate-js/      # EPUB/MOBI reader engine
│   ├── 📂 pdfjs/           # Mozilla pdf.js viewer (v4.10.38)
│   ├── djvu.js             # DJVU support
│   └── booky-icon.svg      # App icon
├── 📂 server/
│   └── ebook_server.py     # Python server for system apps
├── 📂 src/
│   ├── 📂 components/
│   │   ├── BookCard/       # Book cover cards
│   │   ├── BookGrid/       # Library grid view
│   │   ├── EbookReader/    # EPUB/MOBI/FB2 reader
│   │   ├── PdfReader/      # pdf.js viewer iframe wrapper
│   │   ├── PdfTools/       # Stirling-PDF integration
│   │   ├── CollectionTree/ # Sidebar collections
│   │   └── ...
│   ├── 📂 context/         # React context (state)
│   ├── 📂 services/        # IndexedDB, API services
│   └── 📂 types/           # TypeScript definitions
├── package.json
└── README.md

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Ideas for Contributions

• Cloud sync support
• Book recommendations
• Reading statistics
• Annotation export
• More themes

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Foliate-js - EPUB rendering engine
• PDF.js - Mozilla's PDF viewer
• Stirling-PDF - PDF tools
• DjVu.js - DJVU support