# AstoundDrive - Complete Documentation for LLMs

## Overview

AstoundDrive is a free, privacy-focused Chrome extension by Astound Technology that enables users to download Google Drive folders as AES-256 password-protected ZIP files directly from the Google Drive web interface.

## Extension Details

- **Name**: AstoundDrive - ZIP with Password
- **Short Name**: AstoundDrive
- **Version**: 1.0.0
- **Author**: Astound Technology
- **Manifest Version**: 3
- **Minimum Chrome Version**: 109
- **Homepage**: https://astound.technology

## Architecture

### Content Scripts
The extension injects content scripts into `drive.google.com` pages. These scripts:
- Detect folder pages via URL pattern `/folders/{id}`
- Inject a "Download ZIP" toolbar button into the Google Drive interface
- Display a modal for password entry, filename configuration, and progress tracking
- Manage the full download lifecycle

### Background Service Worker
A background script handles:
- Authenticated file downloads using Google session cookies
- ZIP file saving via `chrome.downloads` API
- Keepalive port for long-running operations

### Popup
A browser action popup that:
- Shows connection status (on/off Google Drive)
- Provides quick access to Google Drive
- Offers a SHA-256 checksum toggle setting

## Core Features

### AES-256 Encryption
- Uses zip.js library for client-side ZIP creation
- Encryption strength level 3 (AES-256)
- Password is optional — unencrypted ZIPs are also supported
- Password strength meter with 4 levels (Weak, Fair, Good, Strong)

### Google Drive Integration
- Uses existing browser Google session — no OAuth/API keys
- Authenticates via Google session cookies (SID, HSID, SSID, SAPISID, APISID)
- Builds SAPISIDHASH headers for API authentication
- Supports both My Drive and shared/team drives

### File Download
- Recursive folder scanning up to 20 levels deep
- Multiple download strategies with automatic retry:
  1. drive.google.com/uc endpoint
  2. drive.usercontent.google.com endpoint
  3. clients6.google.com Drive API with alt=media
- Concurrency-limited parallel downloads (3 simultaneous)
- Google Workspace export routes:
  - Docs → .docx
  - Sheets → .xlsx
  - Slides → .pptx
  - Drawings → .png

### SHA-256 Checksum
- Optional post-download verification
- Computed using Web Crypto API (crypto.subtle.digest)
- Displayed in completion screen with copy-to-clipboard

## Permissions

| Permission | Purpose |
|---|---|
| `storage` | Save user preferences (checksum toggle) |
| `tabs` | Detect Google Drive pages |
| `downloads` | Save ZIP files to user's computer |
| `cookies` | Read Google session cookies for authenticated downloads |
| `*://drive.google.com/*` | Content script injection |
| `*://clients6.google.com/*` | Drive API access |
| `*://drive.usercontent.google.com/*` | File download endpoint |
| `*://docs.google.com/*` | Workspace file export |
| `*://*.googleusercontent.com/*` | Content download |

## Privacy

- Zero data collection
- All processing happens locally in the browser
- No external servers or third-party services
- No analytics, tracking, or telemetry
- Files are processed in-memory only
- GDPR and CCPA compliant by design

## Landing Page

- URL: https://tools.astound.technology/extension/astounddrive/
- Built with Vite + Tailwind CSS
- Sections: Hero, Features, Screenshots, Download, FAQ
- Full Schema.org structured data (SoftwareApplication, FAQPage, BreadcrumbList, Organization)
- Open Graph and Twitter Card meta tags
- Privacy page: https://tools.astound.technology/extension/astounddrive/privacy.html

## Organization

- **Name**: Astound Technology
- **Website**: https://astound.technology
- **GitHub**: https://github.com/astound-technology
- **X/Twitter**: https://x.com/Astound_tech
- **Contact**: contact@astound.technology