Deadline Tracker

WHAT IT DOES

Deadline Tracker is a browser extension that lets you track deadlines with visual countdown timers. You can add custom deadlines with titles and dates, and the tool displays a real-time countdown showing days, hours, minutes, and seconds remaining until each deadline. Each deadline is color-coded based on urgency: green for deadlines more than 3 days away, yellow for 1-3 days, orange for less than 1 day, and red for expired deadlines. A progress bar visually indicates how much time has passed. The tool also scans the page for date strings that may represent deadlines or due dates, allowing you to quickly add them to your tracker. All deadlines are persisted globally and update every second in real time. The tool is ideal for project managers, students, freelancers, and anyone who needs to keep track of multiple deadlines.

WHERE IT RUNS

Deadline Tracker runs on any webpage, overlaying a floating panel that does not interfere with page content. It operates entirely in your browser as a lightweight userscript, using JavaScript's Date object for time calculations. It works on any page, whether static or dynamic, with no external dependencies. All deadline data is stored locally using GM_setValue—no data is ever sent to any server.

HOW TO USE

After installation, open the floating panel by clicking the extension icon. To add a deadline, enter a title in the "Title" field and a date in the "Date" field (supports YYYY-MM-DD or MM/DD/YYYY formats), then click "Add Deadline". The deadline appears in the list below with a countdown timer that updates every second. Each deadline shows the remaining time, a progress bar, and a color-coded border indicating urgency. Deadlines are sorted by date with the closest deadline first. To delete a deadline, click the ✕ button next to it. The panel automatically updates every second, and all deadlines are saved globally across all pages.

REAL MECHANISM — WHY THIS WORKS

Most deadline trackers require opening a separate app or website and manually entering all deadlines. Deadline Tracker uses a persistent, local-storage-based approach that works entirely within your browser. The engine stores each deadline as an object with an id, title, and ISO date string in a JSON array stored in GM_setValue. Every second, a setInterval timer triggers a render function that iterates through all deadlines, calculates the time remaining using JavaScript's Date arithmetic, and updates the display. The time remaining calculation computes the difference between the deadline date and the current date in milliseconds, then converts to days, hours, minutes, and seconds. The urgency color is determined by the remaining time: green for more than 3 days (72+ hours), yellow for 1-3 days (24-72 hours), orange for less than 1 day (1-24 hours), and red for expired deadlines. The progress bar shows how much of the total time window (up to 30 days) has elapsed, giving a quick visual sense of how much time remains. This approach ensures accurate, real-time, and fully private deadline tracking without requiring any external services or network access.

THE PANEL

The floating panel is fully draggable and remembers its position per site, snapping to the edges of the viewport when dragged near them. You can collapse the panel to a small icon to minimize screen distraction and expand it back with a single click. The panel is resizable from the bottom-right corner, giving you more space to view deadlines. Press the Escape key to close the panel instantly. The panel remains open across page navigation within the same domain, maintaining your current view state. All preferences—panel position and all deadline data—are saved globally for a seamless experience.

PLEASE NOTE

Deadline Tracker requires the free BotGentz extension to be installed and enabled, as it relies on the cross-extension messaging API provided by BotGentz for DOM access permissions. The date parser supports YYYY-MM-DD, MM/DD/YYYY, and DD/MM/YYYY formats. All dates are interpreted in the local timezone of your browser. All deadline data is stored locally in your browser using GM_setValue. No deadline data, titles, dates, or usage data are ever sent to any server. The extension does not read, store, or transmit any personal information. It only stores and displays deadlines locally at your request.