Skip to content

princethakur931/PDF-Master

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

113 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PDF Master πŸ“„

A comprehensive web-based PDF manipulation toolkit offering 17+ professional-grade PDF operations. Built with modern technologies for fast, efficient, and secure PDF processing.

⭐ If you find this project helpful, please consider giving it a star on GitHub! ⭐

🌐 Live PDF Master

πŸš€ Visit and Explore: https://pdf-master-two.vercel.app/

Access all PDF tools directly in your browser - no installation, no signup required!

✨ Overview

PDF Master is a comprehensive toolkit that provides 18+ professional PDF tools in one place. Whether you need to merge documents, convert formats, compress files, or perform advanced operations like OCR and digital signatures, PDF Master has you covered.

πŸš€ Features

Core PDF Operations

  • βœ… Merge PDF - Combine multiple PDFs into a single document
  • βœ… Split PDF - Extract specific pages or ranges from PDFs
  • βœ… Compress PDF - Reduce file size while maintaining quality
  • βœ… Rotate PDF - Rotate pages clockwise or counter-clockwise

Format Conversion

  • βœ… PDF to Images - Convert PDF to JPG/PNG format
  • βœ… Images to PDF - Convert JPG/PNG images to PDF
  • βœ… PDF to Word - Convert PDF to editable Word documents
  • βœ… Word to PDF - Convert Word documents to PDF
  • βœ… PDF to Excel - Extract tables and data to Excel
  • βœ… Excel to PDF - Convert spreadsheets to PDF format
  • βœ… XML to PDF - Convert XML files to PDF with formatted structure

Advanced Features

  • βœ… OCR (Optical Character Recognition) - Extract text from scanned PDFs
  • βœ… Watermark - Add custom watermarks to PDFs
  • βœ… Protect PDF - Add password protection to PDFs
  • βœ… Unlock PDF - Remove passwords from protected PDFs
  • βœ… Sign PDF - Add digital signatures to documents
  • βœ… Source Code to PDF - Convert programming code files to PDF with syntax highlighting

User Experience

  • πŸ” Search Functionality - Quickly find the tool you need
  • πŸŒ“ Dark/Light Mode - Toggle between themes for comfortable viewing
  • πŸ“± Responsive Design - Works seamlessly on desktop and mobile devices
  • ⚑ Fast Processing - Optimized for quick file operations
  • πŸ”— Share Without Download - Share processed PDFs and documents directly without downloading

πŸ› οΈ Tech Stack

Frontend

  • React 19.0 - Modern React with latest features
  • React Router - Client-side routing
  • Tailwind CSS - Utility-first CSS framework
  • shadcn/ui - High-quality UI components built on Radix UI
  • Framer Motion - Smooth animations and transitions
  • Lucide React - Beautiful, consistent icons
  • Axios - HTTP client for API requests
  • React Dropzone - Drag-and-drop file uploads
  • React Hook Form - Efficient form handling
  • Sonner - Toast notifications

Backend

  • Python 3.10+ - Backend runtime
  • FastAPI - High-performance async web framework

πŸ“¦ Installation

Prerequisites

  • Python 3.10 or higher
  • Node.js 16 or higher
  • npm or yarn - Package manager
  • MongoDB (Optional - for future features)
  • Tesseract OCR (Required for OCR functionality)

Backend Setup

# Navigate to backend directory
cd backend

# Create virtual environment (recommended)
python -m venv venv

# Activate virtual environment
# Windows:
venv\Scripts\activate
# Mac/Linux:
source venv/bin/activate

# Install Python dependencies
pip install -r requirements.txt

# Create .env file (optional)
# Add the following variables:
# MONGO_URL="mongodb://localhost:27017"
# DB_NAME="pdf_master"
# CORS_ORIGINS="*"

# Start the backend server
python server.py
# Or using uvicorn:
uvicorn server:app --reload --port 8000

Backend will run on http://localhost:8000

Frontend Setup

# Navigate to frontend directory
cd frontend

# Install Node dependencies
npm install
# Or with yarn:
yarn install

# Start development server
npm start
# Or with yarn:
yarn start

Frontend will open automatically at http://localhost:3000

Quick Start (Both Servers)

For Windows users, convenience batch files are provided:

Recommended: Start everything at once

# Simply double-click or run from command line:
start-all.bat

This will automatically start both backend and frontend servers.

Or start individually:

cd backend
start.bat

cd frontend
start.bat

πŸ“ Project Structure

pdf-master/
β”œβ”€β”€ backend/                 # Python FastAPI backend
β”‚   β”œβ”€β”€ server.py           # Main server file with all routes
β”‚   β”œβ”€β”€ requirements.txt    # Python dependencies
β”‚   └── start.bat          # Windows startup script
β”‚
β”œβ”€β”€ frontend/               # React frontend application
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ App.js         # Main application component
β”‚   β”‚   β”œβ”€β”€ pages/         # Page components
β”‚   β”‚   β”‚   β”œβ”€β”€ Home.js    # Landing page with tool grid
β”‚   β”‚   β”‚   └── ToolPage.js # Individual tool pages
β”‚   β”‚   β”œβ”€β”€ components/    # Reusable components
β”‚   β”‚   β”‚   └── ui/        # shadcn/ui components
β”‚   β”‚   β”œβ”€β”€ hooks/         # Custom React hooks
β”‚   β”‚   └── lib/           # Utility functions
β”‚   β”œβ”€β”€ public/            # Static assets
β”‚   β”œβ”€β”€ plugins/           # Custom webpack plugins
β”‚   β”œβ”€β”€ package.json       # Node dependencies
β”‚   └── start.bat         # Windows startup script
β”‚
β”œβ”€β”€ README.md              # Project documentation
└── start-all.bat         # Start both servers (Windows)

πŸ”’ Security

  • Files are processed server-side and automatically deleted after processing
  • No files are permanently stored on the server
  • Password-protected PDFs can be unlocked with proper authorization
  • All operations are performed in isolated temporary directories

🌟 Future Enhancements

This project is actively under development! More tools and features coming soon:

  • πŸ”œ PDF Comparison Tool
  • πŸ”œ Form Field Editor
  • πŸ”œ PDF Annotations & Comments
  • πŸ”œ Batch Processing for multiple files
  • πŸ”œ Cloud Storage Integration
  • πŸ”œ User Accounts & History
  • πŸ”œ API Key Management
  • πŸ”œ Custom Branding Options
  • πŸ”œ Advanced OCR with Multiple Languages
  • πŸ”œ PDF Metadata Editor
  • πŸ”œ E-Signature Verification
  • πŸ”œ PDF Accessibility Checker

🀝 Contributing

Contributions are always welcome! We encourage open collaboration:

Have an idea or feature request?

  • πŸ’‘ Create an issue describing your feature idea
  • πŸ› Report bugs or suggest improvements
  • πŸ’¬ Join discussions on existing issues

Want to contribute code?

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

Feel free to openly contribute to any features you'd like to work on. All contributions, big or small, are appreciated!

πŸ“§ Contact

πŸ“ License

This project is open source and available for personal and commercial use. All files are processed securely and deleted after use.


Made with ❀️ for PDF enthusiasts
Β© 2025 PDF Master

About

πŸš€ PDF Master

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors