Skip to main content

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

Project description

📕 RBV-DL — Module Downloader

Logo RBV-DL

RBV UT DOWNLOADER

PyPI Version Python Versions License

RBV-DL is an asynchronous Python-based tool that automates authentication, retrieves module metadata, downloads pages concurrently using Playwright, and compiles them into a high-quality PDF.

It includes:

  • Secure session handling
  • Credential configuration
  • Concurrent page downloads
  • Real-time progress tracking

Built for speed. Designed for practicality.


Prerequisites

Before installing, you must have Python installed on your system.

  1. Download Python: https://www.python.org/downloads/

  2. During installation, make sure to check: "Add Python to PATH"

This step is mandatory. Skipping it will result in command errors later.


Installation Guide

Choose your operating system below.


Windows

No IDE required. Just use Command Prompt.

  1. Press the Windows Key
  2. Type cmd and press Enter
  3. Run:
pip install rbv-ut-downloader
  1. Then install the required browser engine:
playwright install chromium

Done.


macOS

  1. Press Command (⌘) + Space
  2. Type Terminal
  3. Run:
pip3 install rbv-ut-downloader
playwright install chromium

Linux

You probably already know what you're doing.

Recommended method (cleaner environment):

pipx install rbv-ut-downloader
playwright install chromium

Or standard pip:

pip install rbv-ut-downloader
playwright install chromium

Usage

CLI Version

After installation, open your terminal and run:

rbv-dl

You will be prompted to enter:

  • NIM / Email – Your UT email
  • Password – Your E-Campus password (hidden during input)
  • Course Code – Example: ADPU4433

The tool will authenticate, download the module, and save the PDF inside a folder named after the course code.

No unnecessary configuration. Just run and wait.


GUI Version

A graphical interface is available for users who prefer buttons over terminals.

The application has been packaged as a .deb file for Linux distributions. However, Codeberg currently limits release uploads to 100 MB per file.

The compiled .deb package is approximately 703 MB, which exceeds that limit.

Yes, that is larger than intended.

A Windows executable will be provided once a Windows build environment is available.


Running the GUI from Source (Temporary Solution)

If you need the GUI immediately, you can run it directly from the source code.

1. Clone the repository

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

2. Navigate into the project

cd rbv-dl

3. Create and activate a virtual environment (if not already available)

python -m venv venv
source venv/bin/activate

On Windows:

venv\Scripts\activate

4. Install dependencies

pip install -r requirements.txt
playwright install chromium

5. Run the application

python app.py

The GUI should launch normally.


Troubleshooting

"Command not found" or "rbv-dl is not recognized"

Python is likely not added to PATH. Reinstall Python and ensure "Add Python to PATH" is checked.


"Login Failed"

  • Double-check your E-Campus password
  • Try logging in manually via the RBV website to verify your account status

Disclaimer

This tool is intended for educational and archival purposes only.

Use it responsibly to back up your own learning materials. The author is not responsible for misuse or policy violations.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rbv_ut_downloader-0.1.3.3.tar.gz (21.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rbv_ut_downloader-0.1.3.3-py3-none-any.whl (25.5 kB view details)

Uploaded Python 3

File details

Details for the file rbv_ut_downloader-0.1.3.3.tar.gz.

File metadata

  • Download URL: rbv_ut_downloader-0.1.3.3.tar.gz
  • Upload date:
  • Size: 21.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for rbv_ut_downloader-0.1.3.3.tar.gz
Algorithm Hash digest
SHA256 33f27ebd7cbb9ede285348ec58839af290c120d106794f2d86048039b1f42b47
MD5 237c09330e3bf09776bdf86bce889700
BLAKE2b-256 eda4a94dc1b52315cf3c232ed4854d8f17e5b86ec32012005bd510e1d377962e

See more details on using hashes here.

File details

Details for the file rbv_ut_downloader-0.1.3.3-py3-none-any.whl.

File metadata

File hashes

Hashes for rbv_ut_downloader-0.1.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9516de3a219f2de6fb92fce2a39c48548e84aadd7b6b3a91b9fb127521872746
MD5 f472889ab44c24acbbea8f4b93bad3cb
BLAKE2b-256 67a1030adba7f79219f8bd014dad81088e6361354b9c6b79acdfc163dbebc092

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page