Dropbox Web File Age Highlighter

WHAT IT DOES

Dropbox Web File Age Highlighter scans your Dropbox web file listings and highlights files based on how old they are. Green indicates recent files (under 7 days), yellow for moderate (7-30 days), orange for aging (30-90 days), and red for old files (over 90 days). Each file row gets a colored left border and a subtle background tint, making it easy to spot old files that can be archived or deleted. Age badges show the exact age next to each file name, and tooltips display the modified/created date and exact age on hover. A summary panel shows total files, average file age, oldest file, and a breakdown of files by age category. You can sort files by age to bring the oldest files to the top. This helps you clean up your Dropbox, identify stale files, and manage storage space more effectively.

WHERE IT RUNS

This script runs on Dropbox web file listing pages (*.dropbox.com/*). It operates entirely within your browser tab, reading the page's DOM to locate file rows, extract modified/created dates, and apply highlighting. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including age thresholds, highlight colors, age badge visibility, sort preference, date preference, and auto-analyze preference—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically analyzes files on Dropbox pages you view (if auto-analyze is enabled). The panel shows a summary with total files, average age, oldest file, and a breakdown by age category. Each file row is color-coded with a left border and subtle background. Age badges appear next to file names showing the age in hours or days. Hover over any file to see its modified/created date and exact age. Click "Analyze Files" to manually trigger analysis if auto-analyze is off. Adjust age thresholds in the settings to customize what counts as "Recent," "Moderate," "Aging," and "Old." Change highlight colors to match your preferences. Toggle age badges on or off, enable sorting by age, and choose whether to use modified date or created date. Copy a full file age report to your clipboard.

THE REAL MECHANISM

The script detects Dropbox file rows using multiple selectors (.file-row, .file-item, .list-item, .table-row, .dropbox-file) to handle different Dropbox UI versions. For each file, it extracts the file name from .file-name, .filename, or .name, the modified date from .modified, .modified-date, or [data-testid="modified"], and the created date from .created, .created-date, or [data-testid="created"]. Dates are parsed using a flexible parser that handles Dropbox's formats ("Dec 31, 2024", "MM/DD/YYYY", etc.). Based on user-configurable thresholds (defaults: 7, 30, 90 days), each file is assigned to one of four categories: Recent, Moderate, Aging, or Old. Highlighting is applied by setting a left border color and a subtle background tint on each file row. Age badges are inserted next to the file name, and tooltips are added to file rows. If sorting is enabled, the file rows are reordered in the DOM from oldest to newest. The summary panel aggregates statistics across all files found on the page. All DOM manipulation uses safe methods with no innerHTML from untrusted content.

THE PANEL

The File Age Highlighter panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the summary and settings. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. Dropbox frequently updates its UI, which may change class names, data-testid attributes, and DOM structure—the script may require updates to maintain compatibility. The extraction of dates relies on date fields being visible on the page; if the Modified or Created columns are not displayed, the script may not detect files. The sorting feature rearranges DOM elements on the page, which may affect other scripts or browser extensions that interact with file rows. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your age thresholds, highlight colors, age badge visibility, sort preference, date preference, and auto-analyze preference locally. No file data, Dropbox information, or personal information is ever collected, transmitted, or shared.