Trello Due Date Calendar Export

WHAT IT DOES

This script exports Trello cards with due dates to a calendar file format. When you open a Trello board, the script scans all cards, extracts those with due dates, and compiles their title, description, due date, list name, and completion status. You can export this data as an iCalendar (.ics) file—which can be imported into Google Calendar, Outlook, Apple Calendar, and other calendar applications—or as CSV or JSON. A preview in the settings panel shows upcoming due dates so you can see what will be exported. Options let you include or exclude completed cards. The script updates dynamically as you add, move, or modify cards.

WHERE IT RUNS

The script runs on all Trello pages (*.trello.com). It works on board pages and card lists. It supports both desktop and mobile views.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Enable calendar export" toggle enables or disables the script.

- The "Upcoming Due Dates" section shows a preview of cards with due dates.

- Choose the export format from the dropdown: "iCalendar (.ics)," "CSV," or "JSON."

- Toggle "Include completed cards" to include or exclude completed cards from the export.

- Click "Export" to download the file.

- Click "Refresh preview" to manually update the preview list.

The script works automatically—just open your Trello board and the upcoming due dates will appear in the panel.

TECHNICAL SECTION — REAL MECHANISM

The script detects Trello board pages by checking the URL for /b/ or /boards/. It finds cards using selectors like .card, .list-card, .card-detail, and .card-short. For each card, it extracts the title from .list-card-title or .card-title, the description from .list-card-description or .card-description, the due date from .badge-text or .due-date-badge (parsing "MMM DD, YYYY" format), the list name from the parent list's .list-header-name, and the completion status by checking for .icon-check or .completed. Cards without due dates are filtered out. The iCalendar export generates a standard .ics file with VEVENT entries for each card, using the due date as the event start time and adding a 1-hour duration. The CSV export generates a spreadsheet with columns for Title, Due Date, List, Description, and Completed. The JSON export generates a structured JSON array. The preview shows the first 20 upcoming due dates sorted by date. A MutationObserver watches for DOM changes and updates the preview dynamically.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. Trello frequently updates its interface and class names, which may affect the selectors used to find cards and due dates. If the script stops working, please check for updates. The due date extraction relies on Trello's date display format—if Trello changes the date format, the script may not detect dates correctly. The iCalendar export uses the due date as a date-time event; for all-day events, you may need to adjust the import settings in your calendar application. The script stores only your preferences via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.