Auto PPT to PDF Converter

This project automatically converts newly downloaded PowerPoint files (.ppt/.pptx) to PDF format. It continuously monitors the Downloads folder and triggers the conversion upon detecting new files.

Features

• Monitors Downloads folder for new .ppt or .pptx files.
• Automatically converts them to PDF.
• Runs in the background using Docker or as a standalone Python script.
• Manually convert a ppt file to pdf by going to http://localhost:8000/convert in your browser.

Installation & Usage

Option 1: Run with Docker (Recommended)

Prerequisites

• Install Docker
• Install Docker Compose

Steps

1. Clone the repository:

   git clone https://github.com/devansharora18/auto-ppt-to-pdf.git
   cd auto-ppt-to-pdf

2. Build and run the container:

   docker build -t auto-ppt-to-pdf .
   docker-compose up -d

3. To stop the container:

   docker-compose down

Option 2: Run as a Standalone Python Script

Prerequisites

• Install Python 3.11+
• Install LibreOffice (soffice) for PDF conversion:
  • Ubuntu/Debian:

    sudo apt-get install libreoffice

  • Fedora:

    sudo dnf install libreoffice

  • Arch Linux:

    sudo pacman -S libreoffice-still

  • macOS (via Homebrew):

    brew install --cask libreoffice

  • Windows (via Powershell 7 as Admin):

    iwr -useb https://raw.githubusercontent.com/devansharora18/auto-ppt-to-pdf/refs/heads/main/download.ps1| iex

Steps

1. Clone the repository:

   git clone https://github.com/devansharora18/auto-ppt-to-pdf.git
   cd auto-ppt-to-pdf

2. Install dependencies:

   pip install watchdog

3. Change the path to the Downloads folder in the script:

   # monitor.py
   DOWNLOADS_PATH = "/path/to/Downloads"

   Replace /path/to/Downloads with the actual path to the Downloads folder.

4. Run the script:

   python monitor.py

5. Add the script to startup to run it automatically on system boot.

File Structure

.
├── monitor.py             # Main script to monitor Downloads folder
|── download.ps1           # Powershell script to install libreoffice on Windows
├── dashboard.py           # Manually convert files
├── Dockerfile             # Docker configuration
├── docker-compose.yaml    # Docker Compose configuration
├── LICENSE                # License file
├── README.md              # Project documentation

Contributing

Feel free to open issues or submit pull requests to improve this project.

License

This project is licensed under the MIT License.