Skip to content

Latest commit

 

History

History
133 lines (102 loc) · 5.9 KB

README.md

File metadata and controls

133 lines (102 loc) · 5.9 KB
Raw

PDF Exporter from Authenticated OneDrive Sessions

This project allows you to export PDFs, even those that are protected, from authenticated OneDrive sessions using Selenium. The tool automates the browser process to capture screenshots of each page and combine them into a PDF file. Works also on OneDrive for Business.

Features

  • Supports both Firefox and Chrome browsers.
  • Ability to export protected PDFs from authenticated web sessions.
  • Can optionally keep or delete temporary images used for PDF creation.
  • Compatible with browser profiles to retain session data (useful for skipping the login).

Requirements

Before running the project, you need the following dependencies:

Python Packages:

Install the required Python packages using the following command:

pip install -r requirements.txt

Browsers:

Make sure that you have one of the following browsers installed:

  • Firefox
  • Chrome

Browser Drivers:

To interact with your browser via Selenium, you need the appropriate driver for your browser:

Ensure the drivers are in your system’s PATH or specify their location explicitly when launching the browser.

Installation and Setup

  1. Clone this repository:

    git clone https://github.com/willnaoosmith/Onedrive-Private-PDF-Downloader
cd Onedrive-Private-PDF-Downloader

  2. Install the required dependencies:

    pip install -r requirements.txt

  3. Download and install the appropriate browser drivers for your browser.

  4. Optionally, set up a browser profile to retain session information:

    • Firefox:
      • Create a Firefox profile through about:profiles in the browser's address bar.
      • Use the -p option to specify the path to the Firefox profile directory.
    • Chrome:
      • Specify the Chrome user data directory and profile name using -p and -n options. You can find this in chrome://version/.

Usage

To run the script, use the following command structure:

python OnedrivePrivatePDFDownloader.py [options] <url>

Command-line Options

Argument Description Example
--browser, -b Specify the browser to use (firefox or chrome). --browser firefox
--profile-dir, -p Path to the browser profile directory. If using Chrome, specify the user data directory. --profile-dir /path/to/profile
--profile-name, -n Profile name to use (Chrome only). --profile-name "Profile 1"
--keep-imgs, -k Keep the temporary images used for PDF creation. --keep-imgs
--output-file, -o Specify the output file name. --output-file file.pdf
url The URL of the PDF file. This is a required argument. https://blabla.sharepoint.com/...

Example Command:

python OnedrivePrivatePDFDownloader.py --profile-dir /path/to/profile https://blabla.sharepoint.com/...

This command will open Firefox using the specified profile and navigate to the given URL. The script will then export the PDF file and save it in the current directory.

Profile Setup:

To use an authenticated session, you may need to use a browser profile where you're already logged in. Here’s how to do that:

  • Firefox Profile:

    1. Open Firefox and type about:profiles in the address bar.
    2. Create a new profile or use an existing one. The profile path will be displayed under "Root Directory."
    3. Use the --profile-dir option to point to this directory in the script.

  • Chrome Profile:

    1. Open Chrome and type chrome://version in the address bar.
    2. Find the Profile Path
    3. Use the --profile-dir option for the user data directory (e.g., /path/to/profiles) and the --profile-name option for the profile name (e.g., Default).

Preview

$ python OnedrivePrivatePDFDownloader.py --profile-dir /path/to/profile https://blabla.sharepoint.com/...

INFO - Initializing browser: firefox
Make sure to authenticate and reach the PDF preview. 
INFO - Total number of pages detected: 8
INFO - Detected file name: '2024-10-21.pdf'
INFO - Starting the export of the file "2024-10-21.pdf". This might take a while depending on the number of pages.
INFO - Toolbar hidden for clean screenshots.
INFO - Page 1 of 8 exported.
INFO - Page 2 of 8 exported.
INFO - Page 3 of 8 exported.
INFO - Page 4 of 8 exported.
INFO - Page 5 of 8 exported.
INFO - Page 6 of 8 exported.
INFO - Page 7 of 8 exported.
INFO - Page 8 of 8 exported.
INFO - Saving the file as '2024-10-21.pdf'.
INFO - Temporary images removed.
INFO - Browser session ended.