Skip to content

adhamhaithameid/Classroom-Quick-Downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4,638 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ“ Classroom Quick Downloader

Classroom Quick Downloader Hero

Download Google Classroom files in one click instead of one-by-one.

Built for students who want speed, fewer clicks, and less friction during busy weeks and exam season.

Install on Chrome Β· Install on Firefox Β· Install on Edge

Current Version License CI


πŸ“š Table of Contents


πŸš€ Why CQD

Downloading class files one-by-one wastes time and focus. CQD makes the common student workflow faster:

  • One-click bulk downloads for assignment materials.
  • Less friction around Google Drive confirmation pages.
  • Works across Chrome, Firefox, and Edge.
  • Built to feel simple for users while staying reliable behind the scenes.

✨ Features

  • πŸ“¦ Bulk Downloads: Download all files from a Classroom post with one click.
  • πŸ”“ Smart Drive Handling: Automatically handles Drive confirmation/bypass flows.
  • πŸ”„ Multi-Account Compatibility: Better behavior when multiple Google accounts are signed in.
  • πŸ“Š Local Activity Stats: See your own download stats directly in the popup.
  • πŸ›‘οΈ Privacy-First Analytics: Anonymous operational metrics only, no personal file content.

πŸ–ΌοΈ In Action

Download Controls in Classroom

CQD Download Buttons

Success State After Download

CQD Success State


⚑ How to Use

  1. Install CQD from your browser store.
  2. Open Google Classroom and go to a post with attachments.
  3. Click CQD download controls to start one-click or bulk download.
  4. Keep studying instead of manually opening each file.

🎯 Benefits

  • Saves time during busy periods: fewer repeated clicks.
  • Reduces manual mistakes: consistent workflow when many files are involved.
  • Improves reliability: edge/backend pipeline supports better diagnostics and fixes.
  • Improves continuously: anonymous telemetry helps prioritize quality improvements across extension + services.

πŸ› οΈ Ops Status

  • Latest full scan date: 2026-02-28 (security and dependency scans clean).
  • Cloudflare website traffic sync is implemented in Oracle dashboard APIs/UI.
  • Remaining rollout blocker is operational only: attach root custom domain to Cloudflare Pages, then apply redirect/env cutover.
  • Detailed status: docs/MAJOR_SCAN_2026-02-28.md and docs/DEPLOYMENT_RUNBOOK.md.

πŸ“– Backstory: From Lecture Notes to Real Tool

The project started from a simple student pain point: repetitive downloads in Google Classroom.

What began as sketches on paper turned into a production extension used across multiple browsers and operating systems.

πŸ“ The Paper Manifesto

The original system idea started in a university lecture as handwritten architecture notes, then moved into iterative builds and testing. View the original handwritten system sketch.

πŸ“ˆ The Evolution

  • V1: Native JavaScript prototype.
  • Modern CQD: WXT + React extension with an edge + backend analytics stack.

πŸ§ͺ Validating the Pain

Peer feedback confirmed the same pattern: manual downloading is slow, especially near exams when file volume spikes.

πŸ›‘οΈ The Goal

Make downloading class materials boringly easy, so students spend time learning, not clicking.


πŸ“¦ Installation

Choose Your Browser

Browser Install Link How to Install
Chrome Chrome Web Store Click β†’ Add to Chrome β†’ Add Extension
Firefox Firefox Add-ons Click β†’ Add to Firefox β†’ Add
Edge Edge Add-ons Click β†’ Get β†’ Add Extension

After Installing

  1. Pin the CQD icon in your toolbar.
  2. Open Google Classroom.
  3. Open an assignment/post with files.
  4. Use CQD buttons to download faster.

Want local development setup? See DEVELOPMENT.md.


πŸ”’ Privacy at a Glance

CQD is built to avoid personal tracking.

βœ… We Collect ❌ We Never Collect
File type + status (success/fail/cancelled) File contents
Browser + OS Names/emails
Country-level usage (derived at edge) Passwords/Google credentials
Performance/health metrics Personal browsing history

Full details: PRIVACY.md


❓ FAQ

Does this work only on Google Classroom?

Yes. CQD is intentionally focused on classroom.google.com workflows.

Do you collect my files or account credentials?

No. CQD does not collect file contents, passwords, or personal account identity.

Is cancellation tracking always perfect?

Cancellation analytics are highly accurate overall, but extremely fast near-cancel actions right after clicking download can be undercounted due to browser timing races.


🧭 Technical Appendix

CQD is also backed by a distributed reliability pipeline, but the deep engineering docs are split by module for easier reading:

High-Level Architecture

graph TD
    User((Student)) --> Ext[Browser Extension]
    Ext -->|/track batch| Worker[Cloudflare Worker]
    Worker --> DO[Durable Object]
    DO -->|/ingest-batch| Oracle[Go Backend + SQLite]
    Oracle --> Sheets[Daily Google Sheets Archive]
Loading

Security Snapshot

  • Session-based auth for dashboards.
  • Edge-side request controls and rate limits.
  • Privacy-first telemetry with non-PII aggregates.

🀝 Feedback

Found a bug or want a feature?


⚠️ Licensing & Usage

This software is Proprietary & Source Available. Copyright Β© 2025 Adham Haitham. All rights reserved.

  • βœ… You can: view, read, and use the extension for personal, non-commercial use.
  • ❌ You cannot: modify, distribute, or build commercial derivatives from this source.

For commercial or licensing inquiries, contact the repository owner.


Built with β˜• by Adham Haitham

A productivity extension for students, backed by a reliability-focused data pipeline.