Scribd Downloader

Save Scribd documents and embeds as PDF files for offline reading.

---

Features

• Automated Capture - Loads and renders Scribd documents directly via Playwright headless browser
• Smart Waiting - Verifies DOM and image rendering status per page to prevent blank outputs
• Parallel Batch Mode - Download multiple documents concurrently with multi-threading (-f urls.txt -t 4)
• Page Selection - Export the full document or specific page ranges (e.g. 1-10, 5)
• High Resolution - Configurable scaling factor up to 2x for HD rendering
• Auto Sanitization - Cleans document titles to produce safe filenames across OS environments
• Automatic Cleanup - Safely purges temporary screen buffers on completion or exit
• History Tracking - Maintains a structured download log in history.json

---

⚠️ Legal Disclaimer

This tool is intended for personal archival of documents you already have legal access to. Please respect Scribd's Terms of Service and the intellectual property of the original content creators. The developers are not responsible for any misuse of this tool.

---

Installation

1. Clone & Setup Environment

   git clone https://github.com/coflyn/scribdl-py.git
   cd scribdl-py
   python3 -m venv venv
   source venv/bin/activate

2. Install Requirements

   pip install -r requirements.txt
   playwright install chromium

---

Usage

Simply run the script with the document URL:

python main.py <enter>
# or
python main.py "SCRIBD_URL"
# or parallel batch download from file
python main.py -f urls.txt -t 3

CLI Options:

• -f, --file : Path to text file containing list of Scribd URLs (one per line).
• -t, --threads: Number of parallel workers for batch downloading (default: 3).
• -o, --output : Custom output filename.
• -p, --pages : Page selection (all, 3, or 1-10).
• -d, --delay : Custom extra delay per page in seconds (e.g., 0.5).
• -s, --scale : Scale factor (1 for SD, 2 for HD).
• -q, --quiet : Disable progress output (silent mode).

Quick Examples:

# Single URL with custom page range and delay
python main.py "https://www.scribd.com/document/123456789/Sample-Document" --pages "1-10" --delay 0.5

# Parallel batch download from file with 4 threads
python main.py -f urls.txt -t 4

---

Example Output

Single Document Download

$ python main.py
Select mode:
  1. Single URL
  2. Batch file (.txt)
Enter choice [1]: 1
Enter target URL: https://www.scribd.com/document/123456789/Sample-Document

Connecting to Scribd (123456789)...
Document : Sample Document
Pages    : 21
Pages to download [all(default), e.g. 1-5]:
[-] Downloading page 21/21 [####################] 100%
[Sample Document] Converting to PDF...
[✓] Saved: output/Sample Document.pdf

Parallel Batch Download

$ python main.py -f urls.txt -t 3
Batch mode: Found 3 URL(s) to process (using up to 3 parallel threads).

Starting parallel download with 3 worker(s)...

Connecting to Scribd (111111111)...
Connecting to Scribd (222222222)...
Connecting to Scribd (333333333)...
Document : You Are Awesome
Pages    : 6
Document : Keep On Coding
Pages    : 9
Document : Python is the Best
Pages    : 14
[Keep On Coding] Page 1/9 (11%)
[You Are Awesome] Page 1/6 (16%)
[Python is the Best] Page 1/14 (7%)
...
[You Are Awesome] Page 6/6 (100%)
[You Are Awesome] Converting to PDF...
[✓] Saved: output/You Are Awesome.pdf
[✓] Saved: output/Keep On Coding.pdf
[✓] Saved: output/Python Masterclass.pdf

[✓] Batch complete: 3/3 documents downloaded successfully.

---

⚙️ Configuration (config.ini)

You can set permanent default options in config.ini so you don't need to specify CLI flags every time:

[SETTINGS]
# Baseline extra delay per page capture in seconds (default: 0.5)
delay = 0.5

# Scale factor for page capture (2 = HD quality, 1 = Standard quality)
scale = 2

# Default output filename (Leave empty to auto-detect document title)
output =

---

Supported Contents

• Scribd Document
• Scribd Embeds

---

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Don't forget to give a ⭐ if you find this project useful!

---

🐛 Issue Reporting & Support

Found a bug, broken link extraction, or script error? Please feel free to open an issue with the error traceback and the target URL:

👉 Open an Issue on GitHub

---

📄 License

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