rbv-ut-downloader 0.1.4

A simple Python-based tool to automate module downloads from Universitas Terbuka's Virtual Reading Room (RBV).

📕 RBV-DL — Module Downloader

Fast, asynchronous, and reliable module downloader for Universitas Terbuka (UT).

---

📖 About

RBV-DL is a lightweight, asynchronous Python-based tool designed to automate authentication, retrieve module metadata, and concurrently download pages to compile them into high-quality PDFs.

With the introduction of the Hybrid Auth Bridge, RBV-DL now utilizes PyQt6 and QtWebEngine for a robust, seamless experience. The background auto-login system synchronizes sessions effortlessly between the CLI and GUI without requiring manual user intervention.

✨ Key Features

• Smart Session Sync: CLI and GUI share the same authentication logic via the new auth_bridge.
• Zero-Touch Login: Automatic background SSO handling—just input your course code and let the tool do the rest.
• Asynchronous Core: Highly concurrent downloads ensuring maximum speed and efficiency.
• Native GUI: A sleek, responsive, and native-feeling graphical interface built with PyQt6.
• Lightweight Footprint: Efficient architecture without relying on heavy browser engines like Playwright.

---

⚙️ Prerequisites

To run RBV-DL, ensure your system meets the following requirements:

• Python: Version 3.9 or higher.
  • Download from the official Python website.
  • Important: During installation (especially on Windows), ensure the "Add Python to PATH" option is checked.

---

🚀 Installation

Installing RBV-DL is straightforward and universal.

Open your terminal or command prompt and execute:

pip install rbv-ut-downloader

Note for Linux Users: We highly recommend using pipx for a cleaner, isolated environment:

pipx install rbv-ut-downloader

---

💻 Usage

Command-Line Interface (CLI)

To launch the CLI application, simply run:

rbv-dl

You will be prompted to provide:

1. NIM / Email: Your UT account email.
2. Password: Your E-Campus password (input is securely hidden).
3. Course Code: The target module code (e.g., ADPU4433).

The tool will autonomously handle authentication, download the pages concurrently, and generate a final PDF within a directory named after the course code.

Graphical User Interface (GUI)

The new and improved GUI offers an intuitive, lightweight experience natively integrated into your OS. Simply launch the application via your application menu or command line, and follow the on-screen instructions for a seamless downloading process.

---

🛠️ Running from Source

If you wish to contribute or modify the tool locally:

1. Clone the repository

git clone https://codeberg.org/fyodor-dostoevsky-bit/rbv-dl.git
cd rbv-dl

2. Set up a virtual environment

python -m venv venv
# On Linux/macOS
source venv/bin/activate
# On Windows
venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Run the application

python app.py

🧪 Testing

RBV-DL includes a robust unit testing suite built with pytest to ensure stability across core components like the network rate limiter, chapter parsing, and image collection.

To run the tests:

1. Ensure the virtual environment is active.
2. Install test dependencies:

   pip install -r tests/requirements-test.txt
   

3. Run the test suite:

   PYTHONPATH=. pytest
   

Example Output:

================================ test session starts =================================
platform linux -- Python 3.12.3, pytest-9.0.2, pluggy-1.6.0
rootdir: /media/dapa/HDD2/Ubuntu/Desktop/rbv-dl
configfile: pyproject.toml
testpaths: tests
plugins: mock-3.15.1, asyncio-1.3.0
asyncio: mode=Mode.STRICT, debug=False, asyncio_default_fixture_loop_scope=None, asyncio_default_test_loop_scope=function
collected 13 items                                                                   

tests/test_helper.py ...                                                       [ 23%]
tests/test_network.py ......                                                   [ 69%]
tests/test_pustaka_ut.py ....                                                  [100%]

================================= **13 passed** in 0.72s =================================

---

🐛 Troubleshooting

Issue	Solution
Command not found or rbv-dl is not recognized	Python is likely not correctly added to your system's PATH. Reinstall Python and ensure "Add Python to PATH" is selected during setup.
Installation fails on Python 3.14	pythonnet (a transitive dependency) does not yet support Python 3.14 on Windows. Use Python 3.11, 3.12, or 3.13 to install and run the application successfully.
Login Failed	Verify your E-Campus password. Try logging in manually via the official RBV website to ensure your account is active and accessible.

---

⚖️ Disclaimer

Educational Purposes Only This tool was strictly developed for educational and archival purposes to help students back up their learning materials. The author shall not be held responsible for any misuse, policy violations, or unauthorized distribution of downloaded content. Please use it responsibly.