Overview
The Downloads page displays:- Total downloads across all sessions
- Completed downloads that finished successfully
- Dangerous downloads flagged by Chrome’s security checks
- Download history with full details and pagination
Download tracking captures all browser downloads, not just those from agent sessions.
Statistics Cards
Three stat cards at the top provide quick insights:Total Downloads
- Icon: Download icon
- Value: Total number of downloads (all time)
- Description: “All time”
Completed
- Icon: File icon
- Badge: Green (success variant)
- Value: Number of successfully completed downloads
- Description: “Successfully downloaded”
Dangerous
- Icon: Alert triangle icon
- Badge: Red (error variant)
- Value: Number of downloads flagged as potentially harmful
- Description: “Potentially harmful”
Download History Table
The main table displays all downloads with detailed information.Table Columns
| Column | Description |
|---|---|
| Type | Emoji icon representing file category |
| Time | Download time in HH:MM:SS format (24-hour) |
| Date | Download date as MMM DD |
| Filename | File name and source hostname |
| Size | Human-readable file size |
| Category | File category badge (document, image, etc.) |
| Status | Safety status (Safe or Danger badge) |
File Categories
Downloads are automatically categorized:Documents
📄 PDF, DOC, TXT filesBadge: Blue
Spreadsheets
📊 XLS, XLSX, CSV filesBadge: Green
Presentations
📽️ PPT, PPTX filesBadge: Purple
Images
🖼️ PNG, JPG, GIF, SVG filesBadge: Pink
Videos
🎬 MP4, AVI, MOV filesBadge: Red
Audio
🎵 MP3, WAV, OGG filesBadge: Indigo
Archives
📦 ZIP, TAR, GZ, RAR filesBadge: Yellow
Executables
⚙️ EXE, DMG, APP filesBadge: Orange
Code
💻 JS, PY, HTML, CSS filesBadge: Cyan
Data
📊 JSON, XML, SQL filesBadge: Teal
Other
📁 Uncategorized filesBadge: Gray
Download Details
Each download row displays:Filename and Source
- Top line: Full filename (truncated if too long, hover to see full name)
- Bottom line: Hostname of the download source (e.g.,
github.com)
Time Information
- Time: 24-hour format (e.g.,
14:30:45) - Date: Abbreviated month and day (e.g.,
Jan 15)
File Size
Human-readable format:123 B- Bytes4.5 KB- Kilobytes12.3 MB- Megabytes1.2 GB- Gigabytes
Safety Status
- Green “Safe” badge: Download passed Chrome’s security checks
- Red “Danger” badge with alert icon: Download flagged as potentially harmful
Pagination
The table shows 20 downloads per page.Pagination Controls
- Previous button: Go to previous page (disabled on page 1)
- Page indicator: “Page X of Y”
- Next button: Go to next page (disabled on last page)
- Results summary: “Showing X to Y of Z downloads”
Refreshing Data
The page auto-refreshes every 5 seconds to capture new downloads. You can also manually refresh:- Click the Refresh button in the top-right
- Refreshing resets to page 1
- Current downloads are reloaded from Chrome storage
Auto-refresh ensures you see new downloads as they happen, without manual intervention.
Empty States
No Downloads Yet
If you see this message:- No downloads have been tracked
- Chrome storage was cleared
- The extension hasn’t captured any downloads yet
- Download icon
- “No downloads yet” heading
- “Download activity will appear here” message
Download Tracking
Downloads are tracked using Chrome’sdownloads API:
- Background script listens for
chrome.downloads.onCreated - Download metadata is captured:
- Filename, URL, referrer
- File size, MIME type, extension
- Start time, state, danger status
- Categorization based on extension
- Download is saved to
chrome.storage.local(key:downloadRequests) - Dashboard loads and displays the data
Use Cases
Security Auditing
Review downloads to:- Verify no malicious files were downloaded
- Check for unexpected executable downloads
- Audit file sources and types
Data Exfiltration Detection
Monitor for:- Large downloads of data files
- Downloads from unexpected domains
- Multiple downloads in quick succession
Compliance Reporting
Track:- What files agents downloaded
- When downloads occurred
- File types and categories
Best Practices
Investigate dangerous downloads
Always review red-flagged downloads immediately. Delete if suspicious.
Check unknown sources
If a download is from an unfamiliar domain, investigate before opening the file.
Technical Details
The Downloads page:- Loads from
chrome.storage.local(key:downloadRequests) - Auto-refreshes every 5 seconds via
setInterval - Shows 20 items per page
- Categorizes files based on extension mapping
- Highlights dangerous downloads with red background
- Uses Chrome’s
downloadsAPI danger and state flags
Danger States
Chrome’s download API can flag downloads as:- safe: No threat detected
- dangerous: Known malware or virus
- uncommon: Rarely downloaded, potentially risky
- dangerous_content: Harmful content detected
- dangerous_host: Downloaded from known malicious host
- potentially_unwanted: PUP (Potentially Unwanted Program)
Next Steps
Review Sessions
See which sessions initiated downloads
Check Domains
Review domains where downloads originated