97 lines
4.9 KiB
Markdown
97 lines
4.9 KiB
Markdown
# 🌟 Brightwheel Exporter (Chrome Extension)
|
|
|
|
[](LICENSE)
|
|
[](manifest.json)
|
|
[](#installation)
|
|
|
|
> **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)
|
|
|
|
1. **Clone or download this repository:**
|
|
```bash
|
|
git clone https://github.com/CoderSherlock/brightwheel-exporter.git
|
|
```
|
|
2. Open Google Chrome and navigate to:
|
|
```
|
|
chrome://extensions/
|
|
```
|
|
3. Enable **Developer mode** using the toggle switch in the top-right corner.
|
|
4. Click the **Load unpacked** button in the top-left corner.
|
|
5. Select the cloned `brightwheel-exporter` directory.
|
|
6. The **Brightwheel Exporter** icon will now appear in your browser toolbar!
|
|
|
|
---
|
|
|
|
## 📖 How to Use
|
|
|
|
1. Log into your Brightwheel account in Chrome at [https://schools.mybrightwheel.com](https://schools.mybrightwheel.com).
|
|
2. Navigate to your child's page (or open any Brightwheel feed).
|
|
3. 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).
|
|
4. Click **Open Exporter Dashboard**.
|
|
5. 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**.
|
|
6. 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](LICENSE). See `LICENSE` for more information.
|