Studocu Helper

A lightweight Chrome extension that enhances your Studocu experience by automatically bypassing paywalls and enabling clean PDF exports.

Version: 2.0

Overview

Studocu Helper is designed to remove visual obstructions and access restrictions when viewing academic documents on Studocu. The extension provides a seamless "one-click" solution to clean up the interface and export documents in a print-ready format.

Key Features

1. Automatic Paywall Bypass

The core feature that makes this extension powerful:

• Auto-clear cookies: Automatically clears all Studocu cookies (including httpOnly) on every page load
• Remove blur overlays: Eliminates visual obstructions that hide document content
• Remove watermarks: Hides logos, promotional text, and popup overlays
• Restore functionality: Re-enables text selection and scrolling
• Manual re-bypass: Optional button to manually clear cookies if needed

2. Clean PDF Export

Export documents for offline reading or printing:

• Smart rendering: Automatically detects and processes all document pages
• Style preservation: Maintains original fonts, layout, and formatting
• A4 optimization: Auto-adjusts margins and page size for standard printing
• Artifact-free: Eliminates the "black line" artifacts commonly seen in web-to-PDF conversions
• Layer system: Separates background images and text for optimal quality

3. Floating Control Panel

Modern, unobtrusive interface:

• Always accessible: Circular toggle button in bottom-right corner
• Collapsible panel: Expands to top-right when needed
• Compact design: Minimal screen space usage
• Mobile-friendly: Responsive design works on all screen sizes
• Status indicator: Real-time feedback on operations

---

Installation

Since this is a personal development tool (not published on Chrome Web Store), you'll need to install it manually in Developer Mode:

Step 1: Download the Extension

• Download the .zip file or clone this repository
• Extract the files to a folder on your computer

Step 2: Enable Developer Mode

1. Open Chrome and navigate to chrome://extensions/
2. Toggle "Developer mode" in the top-right corner

Step 3: Load the Extension

1. Click "Load unpacked"
2. Select the extension folder from the extracted files
3. The extension icon should appear in your toolbar

---

Usage

Basic Workflow

1. Visit a Studocu document page

   • Navigate to any document on studocu.com or studocu.vn
   • The extension automatically bypasses restrictions on page load

2. Access the control panel

   • Click the circular button in the bottom-right corner
   • The panel will slide out from the top-right

3. Export to PDF (if needed)

   • Scroll to the bottom of the document to ensure all pages are loaded
   • Click "Tạo file PDF" in the control panel
   • Confirm the page count in the dialog
   • Wait a few seconds for processing
   • The print dialog will open automatically

4. Manual bypass (if needed)

   • Click "Bypass thủ công" to manually clear cookies
   • The page will reload automatically after clearing

Control Panel Features

Tạo file PDF - Export the document as a clean, printable PDF Bypass thủ công - Manually clear cookies and reload the page Status indicator - Shows current operation status (auto-bypassed, processing, etc.)

---

What's New in v2.0

• Automatic bypass: Cookies are cleared automatically on every page load
• Floating panel: Control panel injected directly into the page (no popup window)
• Mobile-friendly: Responsive design works on smaller screens
• Manual override: Keep the manual bypass button for edge cases
• Compact UI: Reduced spacing for a cleaner, more efficient interface
• Better performance: Background service worker handles cookie management

---

Technical Details

Why a Chrome Extension?

This tool must be a Chrome extension (not a userscript) because:

• httpOnly cookie access: Studocu uses httpOnly cookies for access control
• Browser security: Only extensions with the cookies permission can access/delete httpOnly cookies
• Userscript limitation: Tampermonkey/Greasemonkey scripts cannot access httpOnly cookies due to browser security restrictions

Architecture

• Manifest V3: Uses the latest Chrome extension format
• Background worker: Handles automatic cookie clearing on page navigation
• Content scripts: Injects the floating panel and CSS overrides
• Chrome APIs: Uses chrome.cookies, chrome.scripting, and chrome.webNavigation

Permissions

• cookies - Required to clear httpOnly cookies
• scripting - Required to inject PDF export functionality
• webNavigation - Required to detect page loads for auto-bypass

---

Browser Compatibility

Desktop

• Chrome (Recommended)
• Edge (Chromium-based)
• Brave
• Opera
• Any Chromium-based browser

Mobile

• Kiwi Browser (Android) - Works without modifications
• Firefox Mobile (Android) - Requires minor modifications (Manifest V2)
• Mull Browser (Android) - Firefox fork, same as Firefox Mobile
• Chrome Mobile - Does not support extensions
• Safari Mobile - Limited extension support

---

Disclaimer

This tool is created for educational and personal research purposes. Please use it responsibly and respect the copyright of original documents. The extension is provided "as-is" without any warranties.

---

Contributing

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

---

License

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

---

Author

@ruskicoder

---

Star History

If you find this tool useful, please consider giving it a star!