Genius Web Annotation Contribution Tracker

WHAT IT DOES

This tool helps you track your Genius annotation contributions and monitor your progress as a contributor. It extracts song titles, lyric snippets, contribution status (accepted, pending, rejected), points earned, and contribution dates from the page. The panel displays a comprehensive stats dashboard showing total accepted, pending, rejected, and total contributions, along with total points earned and acceptance rate. Recent contributions are listed with status indicators—green for accepted, yellow for pending, red for rejected. A per-song summary shows how many contributions you've made to each song with breakdowns by status. Quick "View" buttons open each annotation in a new tab for easy review.

WHERE IT RUNS

The script activates on Genius pages (genius.com), including user contribution pages, profile pages, and annotation history views. It automatically detects contribution data using multiple extraction strategies that work across different Genius layouts. The panel appears as a draggable overlay that stays accessible as you browse your contributions.

HOW TO USE

Navigate to your Genius contribution history page. The panel will appear showing your contribution statistics. Toggle "Show Rejected/Hide Rejected" to control whether rejected contributions appear in the list. Use the "Sort" dropdown to order contributions by date, status, or song title. Set the "Refresh (s)" input to control how often the script checks for updates (default 60 seconds). The "Refresh" button manually updates the data. The score section shows your total points and acceptance rate. The per-song summary shows which songs you've contributed to most and how your contributions were received. Click the "View" button on any contribution to open its annotation page in a new tab.

THE TECHNICAL MECHANISM

The script employs a multi-strategy DOM extraction approach for Genius's contribution interface. It first attempts structured selectors targeting known class names like .annotation-contribution, .contribution-item, and .annotation-item, then falls back to heuristic detection of contribution containers based on content patterns including status indicators ("accepted", "pending", "rejected") and contribution-related keywords. Song titles are extracted from dedicated song elements or by parsing the first non-status text line. Lyric snippets are extracted from quote patterns or snippet elements. Status detection uses pattern matching for accepted/approved, pending/awaiting/in review, and rejected/declined indicators. Points are extracted from patterns like "X points" or "X pt". Contribution dates are extracted from date patterns and used for sorting when available. The acceptance rate is calculated as accepted / (accepted + rejected) * 100. The per-song summary aggregates contributions by song title, counting accepted, pending, and rejected contributions for each. The auto-refresh uses setInterval with a user-configurable interval, and a MutationObserver watches for page updates. All settings are persisted using GM_setValue.

THE PANEL

The panel is fully draggable by its header and remembers its position on the page across sessions. It can be collapsed to a small bubble using the minimize button, then restored by clicking the bubble. The panel resizes automatically to fit its content and can be closed with the Escape key or by clicking the close button. The panel's position and state persist globally, so it returns to the same location on subsequent visits.

PLEASE NOTE

Requires the free BotGentz extension to run. Genius may update its site structure, which could affect the script's ability to detect contribution data — updates will be released as needed. All contribution data is read from the page and displayed locally; nothing is transmitted externally. The script reads data from the visible page and does not access any data beyond what is visibly presented. The script does not modify your Genius account or contributions. The acceptance rate calculation uses only accepted and rejected contributions; pending contributions are excluded from the denominator. This tool is for informational purposes only and is not affiliated with Genius.