Today Dashboard

Files

Opening the dashboard

Basic use (no helper)

Double-click today.html to open it in your browser. Everything except Sync Notion and the calendar works.

Full use (with helper)

1. Open Terminal, go to the Today folder, and start the helper:

   python3 today_server.py

2. Open http://127.0.0.1:8787 in your browser.
3. Leave Terminal open while you use the dashboard. Press Ctrl+C in Terminal to stop the helper.

Do I need the helper?

No. The helper (today_server.py) is optional. It exists for two features that a web page can't do on its own:

• Today's Schedule (your calendar). Browsers block a page from reading your Google Calendar feed directly, and the feed link is a secret that shouldn't be written into the page. The helper fetches it for you.
• Sync Notion. Notion's API also can't be called from a plain page, and it needs your secret token. The helper makes the call and keeps the token on your Mac.

The line "Run today_server.py, then open http://127.0.0.1:8787…" was the calendar saying it couldn't find the helper. It has nothing to do with Notion, which has its own button. Both are off until you set them up, and everything else works without them.

When the helper isn't running, the schedule card shows a one-line link to this guide, and Sync Notion shows a message with a Guide button instead of doing nothing.

The sections

Buttons at the top

Each new day

When you open the dashboard on a new day, or leave it open past midnight, it:

• saves yesterday's full state to a history log (the last 90 days),
• clears priorities, habit ticks, post ticks and notes, contacts, and quick notes,
• keeps your habit list, weekday schedules, Post Today list and number of priorities,
• offers yesterday's unfinished priorities through the Carry over button.

Press History to see the log as streaks and a 14-day grid.

Setting up Notion sync

You only do this once.

1. Create an integration. Go to notion.so/my-integrations, press New integration, give it a name, and copy the Internal Integration Secret. It starts with secret_.
2. Create a database in Notion (a full-page database works). Give it two properties:
   • Name (the title property, which Notion creates by default)
   • Date (type: Date)
3. Share the database with the integration. Open the database, press the ••• menu, choose Connections (or Add connections), and pick your integration.
4. Get the database ID. Open the database as a full page. The URL looks like notion.so/yourname/ + a 32-character code + ?v=…. That 32-character code is the ID.
5. Create your settings file. Copy today.config.example.json to today.config.json and fill in:

   {
     "notionToken": "secret_your_token_here",
     "notionDatabaseId": "your_32_character_id_here",
     "calendarIcsUrl": "your_calendar_url_here"
   }

6. Restart the helper. Sync Notion turns on.

Each sync creates one page per day, titled with the date, containing the summary text.

Setting up the calendar

1. In Google Calendar, open Settings (gear icon), then pick the calendar under Settings for my calendars.
2. Scroll to Integrate calendar and copy the Secret address in iCal format. It ends in .ics.
3. Paste it into calendarIcsUrl in today.config.json, then restart the helper.

Troubleshooting

Privacy

• Dashboard data stays in your browser, not on any server.
• The helper runs only on your Mac (127.0.0.1) and refuses requests from other websites.
• Your Notion token and calendar link live only in today.config.json.