🔥 Self-updating domain tracker for Anna's Archive and shadow libraries — with real-time verification and permanent IPFS publishing. Never lose access again.
Current CID: QmYebyxQ7PV6cBMN7SXW2yVBsqb2qkiyUZ93e28KT887vT
| Gateway | Link |
|---|---|
| ipfs.io | Open report |
| dweb.link | Open report |
| Pinata | Open report |
The CID is updated automatically every 12 hours. Older CIDs remain permanently accessible.
| Domain | Status |
|---|---|
| annas-archive.gl | ✅ Active |
| annas-archive.pk | ✅ Active |
| annas-archive.gd | ✅ Active |
| libgen.bz | ✅ Active |
| libgen.gl | ✅ Active |
| libgen.la | ✅ Active |
| libgen.vg | ✅ Active |
| z-library.bz | ✅ Active |
| z-library.se | ✅ Active |
| welib.org | ✅ Active |
⚠️ Some domains (z-lib.gl, go-to-library.sk, etc.) require opening in a browser due to Cloudflare protection.
NEVER follow a "captcha" or "human verification" page that asks you to open PowerShell, CMD, Terminal, or the Run dialog (Win + R) and paste or execute a command.
No legitimate captcha ever requires interacting with your terminal. These pages silently copy a malicious command to your clipboard and trick you into running it — infecting your machine with malware.
If any mirror or link shows this kind of "verification": close the tab immediately and do not paste anything.
open-slum.org ──┐
Reddit / X ──┼──► candidates ──► HTTP verify ──► active ──► IPFS ──► QR / USB
Telegram ──┘
Mastodon ──┘
| Feature | Description |
|---|---|
| 🕷️ Multi-source crawler | open-slum.org + Reddit + X/Twitter + Telegram + Mastodon |
| ✅ Smart verification | curl_cffi with Chrome impersonation to bypass blocks |
| 🚫 Spam filtering | Blocks fake domains and spam Telegram channels |
| 📦 IPFS publishing | Immutable report pinned to Pinata — no server needed |
| 🗳️ Voting system | |
| ⏱️ Auto-scheduled | Runs unattended via cron every 12 hours |
Requirements: Python 3.12+, Git
git clone https://github.com/D4vRAM369/annas-archive-hub
cd annas-archive-hub
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # Linux / macOS
# venv\Scripts\activate # Windows
pip install -r requirements.txt
cp .env.example .env # optional — see Configuration belowThere are two ways to use this tool:
For manual control. Run it, pick an option, see results on screen.
python main.py╔════════════════════════════════════════════════════════════════════════════╗
║ ANNA'S ARCHIVES HUB ║
║ Self-updating domain tracker + IPFS immortality ║
╚════════════════════════════════════════════════════════════════════════════╝
1. Test static domains → checks the hardcoded domain list
2. Test all domains → static + community-voted domains
3. Add a domain manually → propose a new domain for testing
4. Vote for a domain → upvote a candidate domain
5. View pending domains → domains waiting for votes
6. Publish report to IPFS → pin results to Pinata / local node
7. Show latest IPFS hash → display current CID + public URLs
8. Crawl open-slum.org → discover new domains from open-slum
9. Crawl social sources → Reddit, X/Twitter, Telegram, Mastodon
0. Exit
⚠️ Note: The voting system (options 3–5) is currently not functional. New domains are discovered exclusively through the automated crawlers (options 8–9).
Runs everything unattended in sequence: crawl → verify → publish → log. Designed for cron. No interaction needed.
python run.py[1/5] Crawling open-slum.org... → finds candidate domains
[2/5] Crawling social sources... → Reddit, X, Telegram, Mastodon
[3/5] Testing N domains... → verifies each one is alive
[4/5] Publishing to IPFS... → pins report, prints CID
[5/5] Saving log... → appends to logs/update.log
✅ Done
crontab -eAdd this line (replace the path with your actual clone location):
0 */12 * * * cd /home/youruser/annas-archive-hub && source venv/bin/activate && python run.py >> logs/cron.log 2>&1
Copy .env.example to .env and fill in your Pinata credentials for permanent IPFS pinning (free plan: 1 GB):
PINATA_API_KEY=your_key_here
PINATA_API_SECRET=your_secret_hereWithout Pinata: reports publish to your local IPFS node (requires the IPFS daemon running). The tool works without any credentials — IPFS publishing is optional.
anna-archive-hub/
├── main.py # Interactive menu (9 options)
├── run.py # Automated pipeline (for cron)
├── config/
│ └── settings.py # Central configuration
├── core/
│ ├── domain_tester.py # Domain verification with curl_cffi
│ ├── domain_extractor.py # Regex domain extraction from free text
│ ├── open_slum_crawler.py # open-slum.org crawler
│ ├── social_crawler.py # Reddit, X, Telegram, Mastodon sources
│ ├── ipfs_publisher.py # IPFS / Pinata publishing
│ └── voter.py # Community voting system
├── data/
│ ├── current_report.json # Latest generated report
│ └── ipfs_hash.txt # Latest published CID
├── .env.example # Credentials template
└── requirements.txt
See CONTRIBUTING.md.
MIT — Free for all. Keep knowledge alive.