Capture ebook

Capture ebook

Python OS

Python Lint pages-build-deployment CodeQL Advanced

Automatic ebook capture.

This script captures sequential screenshots of an online ebook page viewer.
It automatically saves each page as an image file and simulates pressing a key to advance pages.

⚠️ Disclaimer

  • Use this script ONLY for lawful and personal purposes.
  • Respect the Terms of Service (ToS) of the website or ebook service you use.
  • Do NOT share, redistribute, or publish the captured images without permission.
  • You are fully responsible for ensuring compliance with copyright laws.

Requirements

  • Python 3.9+
  • Dependencies:
    • python3-venv
    • python3-tk
    • python3-dev
    • gnome-screenshot

Usage

Run the script with default settings: Example with custom arguments:

0. Create virtual environment

# create a virtual environment
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt

1. Capture ebooks

# start capturing
python3 ./src/capture_ebook.py \
--outdir screenshots \
--count 100 \
--left 500 --top 100 \
--width 800 --height 900 \
--next-key right \
--per-page-wait 2

And Click the interested window.

2. Test

pip install -r requirements.test.txt
pytest

3. Deactivate environment

deactivate

Arguments

Option Description
--outdir Output directory
--count Number of pages to capture
--start-index Starting filename index
--left Left pixel of capture region
--top Top pixel of capture region
--width Width of capture region
--height Height of capture region
--next-key Key used to move to next page
--pre-wait Seconds to wait before starting
--per-page-wait Seconds to wait before each screenshot
--filename-digits Number of digits in zero-padded filenames
--no-fail-safe Disable PyAutoGUI failsafe (Esc = abort)

Notes

  • Place your browser window so the ebook page fully fits within the capture region.
  • Ensure each page is fully loaded before the script captures it.
  • You can abort safely by moving your mouse to the top-left corner (unless --no-fail-safe is used).