SourceForge Download Trend Chart

WHAT IT DOES

This userscript transforms your SourceForge project download statistics into an interactive analytics dashboard. It reads daily download counts from the project's stats page and displays a professional bar chart showing download activity over time. The chart supports configurable date ranges (7, 30, or 90 days), making it easy to spot trends and patterns. A summary panel shows total downloads, average daily downloads, peak download day with count, and a trend indicator showing whether downloads are increasing, decreasing, or stable (with percentage change). The peak day is highlighted on the chart with a download arrow, making the highest-performing day instantly visible. This is invaluable for open-source project maintainers, software developers, and product managers who need to track download adoption, measure the impact of releases, and understand user engagement patterns over time.

WHERE IT RUNS

The script runs on all SourceForge web application pages at *.sourceforge.net/*, with automatic detection of project download pages and statistics dashboards (paths containing /download or /statistics). It works across all SourceForge interfaces by using multiple selector strategies to find download statistics, date rows, and download counts. The script detects dynamic content loading and re-renders the chart when the stats page updates. It runs across the entire SourceForge domain, ensuring coverage whether you're viewing the main project page, the statistics dashboard, or the detailed download report.

HOW TO USE

Install the script via the BotGentz extension and navigate to any SourceForge project download page or statistics dashboard. The download trend chart panel will appear automatically, showing a bar chart of daily downloads. The summary panel displays total downloads, average daily downloads, trend direction with percentage change, and peak day highlight. Use the panel controls to customize your experience: choose your date range (7, 30, or 90 days), show or hide the daily average, enable or disable the peak day highlight, or toggle auto-refresh on page load. The "Refresh" button manually rescans the page for updated download data, and the "Copy summary" button exports the key metrics to your clipboard for reporting.

THE MECHANISM - DATA EXTRACTION, TREND CALCULATION, AND CANVAS RENDERING

This script identifies download statistics by scanning the page for known SourceForge data elements. It uses a cascading selector strategy that looks for download stat rows (.download-stat-row, .stat-row, .downloads-row), then extracts dates from date elements and download counts from count elements. When direct selectors fail, the script parses tables with download-related headers or scans text for date: count patterns. The data is sorted chronologically and filtered by the selected date range. Metrics are calculated including total downloads, average, peak day, and trend (comparing the average of the first half of the data against the second half). The chart is rendered using the HTML5 Canvas API with anti-aliased bars, data point circles, and a gradient fill on the bars. The trend indicator uses a color-coded arrow (green for up, red for down, gray for stable) with a percentage change label.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the SourceForge page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the chart emoji (📊), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes the summary metrics, chart, and setting controls. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within SourceForge, with the chart updating automatically as you move between projects or views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for SourceForge project maintainers who need to track download trends. The script reads only visible download data from the DOM—it does not access SourceForge's API, your account credentials, or any sensitive information. All settings (date range, toggle states, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your SourceForge data—it only reads and visualizes visible download statistics. The trend calculation is based on data visible on the current page; if the stats page is filtered or paginated, the trend may not represent the full history. If SourceForge updates its website structure, the script may need to be updated to match new selectors. The chart displays data points for days with available data; days with zero downloads may not be included if the stats page omits them.