🌟 Brightwheel Exporter (Chrome Extension)

Save and back up all your child's precious preschool & daycare memories, high-resolution photos, HD videos, daily care logs, and developmental milestones from Brightwheel.

✨ Features

📸 High-Resolution Media Archiver: Downloads original, full-resolution photos and HD videos organized neatly into date folders (/photos/YYYY-MM/ and /videos/YYYY-MM/).
📂 Direct Local Folder Streaming: Streams files directly to your chosen local folder via the File System Access API—no browser memory crashes or ZIP size limits!
📦 Instant ZIP Archive Export: One-click bundle creation using zero-compression STORE packaging for lightning-fast downloads.
🗓️ Complete Daily Care Records: Captures meals, exact nap start/end times and calculated durations, diaper & potty logs, check-in/out records, and medication logs.
🎯 Milestones & Learning Observations: Backs up developmental milestones, curriculum tags, and teacher notes.
🌐 Interactive Offline Timeline Viewer: Bundles a standalone, elegant index.html viewer inside your export so you can search captions, filter events, and relive memories locally with no internet required.
📊 Spreadsheet & Developer Friendly: Generates a clean activities.csv (compatible with Excel, Numbers, and Google Sheets) as well as unified activities.json / manifest.json files.
🛡️ 100% Private & Client-Side: Operates entirely in your browser using your active logged-in Brightwheel session. No passwords, credentials, or child data are ever transmitted to any third-party servers.
⚡ Smart Throttling & Rate-Limiting: Built-in exponential backoff automatically handles API pacing and prevents HTTP 429 rate limit errors.

🚀 Installation (Load Unpacked in Chrome)

Clone or download this repository:

git clone https://github.com/CoderSherlock/brightwheel-exporter.git

Open Google Chrome and navigate to:
```
chrome://extensions/
```
Enable Developer mode using the toggle switch in the top-right corner.
Click the Load unpacked button in the top-left corner.
Select the cloned brightwheel-exporter directory.
The Brightwheel Exporter icon will now appear in your browser toolbar!

📖 How to Use

Log into your Brightwheel account in Chrome at https://schools.mybrightwheel.com.
Navigate to your child's page (or open any Brightwheel feed).
Click the Brightwheel Exporter extension icon in your Chrome toolbar (or click the floating "Export Brightwheel Data" button on the bottom right of the page).
Click Open Exporter Dashboard.
In the Dashboard:
- Select your child from the dropdown (or enter a custom student UUID).
- Choose your date range (All Time, This Year, or Custom Date Range).
- Choose your save mode:
  - Save Directly to Local Folder (Recommended for large feeds)
  - Download as ZIP Archive
- Select the content categories and export formats you wish to include.
- Click Start Complete Export.
Monitor the real-time progress bar and log window as your files and media are safely saved to your computer.

📁 Exported Folder & Archive Structure

[ChildName]_[YYYY-MM-DD]/
├── index.html                   # Interactive offline timeline viewer
├── activities.csv               # Spreadsheet for Excel / Google Sheets / Numbers
├── activities.json              # Complete unified structured data records
├── exporter_job_info.json       # Metadata summary & statistics of the export
├── photos/
│   ├── 2026-08/
│   │   ├── 2026-08-20_abc123.jpg
│   │   └── ...
│   └── 2026-07/
└── videos/
    └── 2026-08/
        └── 2026-08-15_xyz789.mp4

🔒 Privacy & Security

No Remote Servers: This extension is 100% open source and runs entirely on your local machine.
Session Authentication: Uses your existing Brightwheel browser cookies securely. No logins or API keys are ever stored or shared.
Direct S3/CDN Downloads: Media files are downloaded directly from Brightwheel's official AWS S3 buckets and CloudFront distribution endpoints straight to your disk.

⚠️ Disclaimer

This project is an independent, community-driven open-source tool. It is not affiliated with, endorsed by, sponsored by, or associated with Brightwheel or its parent companies. "Brightwheel" is a registered trademark of its respective owner.

📄 License

Distributed under the MIT License. See LICENSE for more information.

4.9 KiB Raw Blame History