Badzoneyv4n/rlrc-pdf-crawler
Domaine:
digital infrastructureType de record:
software
Créateur:
Bad
Hôte:
This is a Tampermonkey-powered automation script that crawls the Rwanda Law Reform Commission (RLRC) website and automatically downloads all active law PDFs skipping only those laws not in force.
# 🕷️ RLRC Rwanda Laws PDF Crawler
This Tampermonkey-based automation script crawls the Rwanda Law Reform Commission (RLRC) website and **automatically downloads all active law PDFs**.
It recursively navigates the site’s folder structure, skips deprecated sections (like "Laws not in force"), and downloads available PDFs one by one. Once complete, it shows a confirmation modal and plays a success sound.
> ✅ **Tested and working on Chrome (with Tampermonkey extension)**.
> ⚠️ Keep the page in **focus** during the crawl — Chrome may pause background tabs and interrupt downloads.
---
## ✨ Features
- 🔁 Fully **recursive folder crawler**
- 📥 Auto-downloads every PDF found
- 🚫 **Skips ignored folders** like “Laws not in force”
- 📍 Uses breadcrumb + internal stack to **track navigation**
- ✅ Shows a **completion modal** on finish
- 🔔 Plays a **sound notification** when done
- 💾 Pure client-side script — no server or API needed
---
## ⚙️ How It Works
1. The script starts on the root RLRC laws page.
2. It:
- Downloads all PDFs in the current folder
- Stores subfolder links in a **stack**
- Visits each folder one by one (depth-first)
- Goes back after finishing each
3. When everything is done:
- It plays a “ding” sound
- Pops a “✅ Done retrieving PDFs” modal in the center of the screen
---
## 🚀 How To Use
### 1. Install Tampermonkey
Install Tampermonkey extension for your browser (Chrome recommended).
### 2. Add the Script
- Create a new Tampermonkey script
- Paste the contents of `rlrc-crawler.user.js`
- Save
### 3. Visit the Website
Go to:
`rlrc.gov.rw`
### 4. Let It Run
- It will begin crawling and downloading PDFs
- Keep the tab active (don’t switch tabs)
- On completion, a modal will appear and a sound will play
---
## 🛠 Configuration
You can update this array to skip more folders:
```js
const IGNORED_FOLDERS = ["Laws not in force"];
```
## 📁 File Structure
rlrc-pdf-crawler/
├── rlrc-crawler.user.js # Tampermonkey sc …