StudyLib Downloader

A tool that helps you download documents from StudyLib websites for educational purposes only. Available as a browser extension, Tampermonkey script, and a bash script. Please respect copyright laws and the terms of service of StudyLib.

✅ Update

The downloader is now fully working on both studylib.es and studylib.net! Sorry for the delay in getting this fixed.

Tampermonkey Script (recommended)

Installation

1. First, install the Tampermonkey browser extension if you don't have it already:

   • Install Tampermonkey for Chrome / Brave
   • Install Tampermonkey for Firefox
   • Install Tampermonkey for Edge

2. Install the StudyLib Downloader script:

   • Click here to install StudyLib Downloader script
   • When prompted by Tampermonkey, click "Install"

Usage

1. Navigate to any StudyLib document page
2. A "Download Document" button will automatically appear in the top-right corner
3. Click the button to begin the document detection process
4. A new tab will open with the document viewer
5. In the document viewer, click the "Download Document" button that appears in the top-right corner

Browser Extension

Installation

Chrome / Brave / Edge

1. Download the latest release and extract it
2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" in the top-right corner
4. Click "Load unpacked" and select the StudyLib-Downloader-Extension folder
5. The extension should now appear in your browser toolbar

Firefox

1. Download the latest release and extract it
2. Open Firefox and navigate to about:debugging#/runtime/this-firefox
3. Click "Load Temporary Add-on" and select any file in the StudyLib-Downloader-Extension folder
4. The extension should now appear in your browser toolbar

Usage

1. Navigate to any StudyLib document page
2. Click the StudyLib Downloader icon in your browser toolbar
3. Click the "Download Document" button
4. The extension will automatically detect the document and begin the download

Bash Script Version

⚠️ DEPRECATED - This version is no longer recommended for use. Please use the Browser Extension or Tampermonkey Script instead.

Why it's deprecated

• Requires installation of Node.js and npm (additional dependencies)
• More complex setup process
• Browser-based solutions are more reliable and user-friendly
• Maintenance burden for multiple platforms

Requirements, Installation & Usage (Click to expand)

Requirements

• Bash shell
• Node.js (v14+)
• npm

Installation

1. Download the latest release and extract the scraper.sh script
2. Make it executable: chmod +x scraper.sh

Usage

./StudyLib-Downloader-Bash.sh <StudyLib-URL>

How It Works (Manual Process)

The tools in this repository automate what could be done manually. Here's how the document extraction process works:

Technical Explanation

StudyLib documents are displayed in embedded document viewers. The actual document URL is hidden within the page. Here's how to find and download documents manually:

1. Find the document viewer URL:

   • Open a StudyLib document page
   • Right-click and select "View Page Source" (or press Ctrl+U)
   • Search (Ctrl+F) for viewer_next/web/study
   • You should find a URL that contains this pattern, often within an iframe or JavaScript code

2. Alternative method - using Developer Tools:

   • Open Developer Tools (F12 or Ctrl+Shift+I)
   • Go to the "Network" tab
   • Reload the page (F5)
   • Filter requests by typing viewer in the filter box
   • Look for requests containing viewer_next/web/study

3. Access the document viewer directly:

   • Copy the complete URL you found
   • Open it in a new tab
   • This will take you to the document viewer page

4. Download the document:

   • In the document viewer, look for the "Download" button (usually in the top-right corner)
   • Click it to start the download
   • The document will download in its original format (usually PDF)
   • If the download button is hidden, run the following command in the developer tools console to emulate a button press: document.getElementById("download").click();

Regional Differences

Different StudyLib regional sites implement document delivery differently:

StudyLib.net:

• Documents are embedded in a viewer accessible via viewer_next/web/study URLs
• Requires navigating to the viewer and clicking the download button
• The tools detect the viewer URL and automate this process

StudyLib.es:

• Implements direct PDF downloads with session-specific tokens
• The PDF URL is stored in a <link rel="preconnect" href="..."> tag in the page source
• Example: https://s2p.studylib.es/store/data/008276655.pdf?k=AwAAAZwyqMXKAAACWIoEQpaDsCYfnRGT8cXO8qcUsn4k
• The session key parameter (after ?k=) changes for each access
• The tools detect these direct URLs and download them directly without needing the viewer

What the Tools Automate

The extension and Tampermonkey script automate this process by:

1. Scanning the page for the document viewer URL using multiple detection methods
2. Navigating to the document viewer URL
3. Simulating a click on the download button
4. Handling the download process

This automation saves time and works even on pages where the document viewer is loaded dynamically or hidden in complex JavaScript.

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC-SA 4.0) - see the LICENSE.md file for details.