Skip to content

timedesk 0.4.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 10:34
· 5 commits to main since this release

Needs the backend update and database migrations 0004_reviews_and_completed to 0007_top_tasks (pnpm --filter @timedesk/db db:migrate, run before the API goes live). Update the desktop app to get the focus guard, multitasking widget and the Linux icon fix.

Today's top 3

  • Pick the 3 tasks that matter most today: a card at the top of the dashboard with a tick box, Start and Stop for each, and "Pick a task" listing the most pressing ones first. Or click the star on any task
  • Tempo knows your top 3: plans put them first, summaries say how many you finished, and you can ask it to set them

Wrap up the day

  • One screen at the end of the day (dashboard button, sidebar, Ctrl+K, and a reminder on the dashboard after 4 pm): stop running timers, fill in the gaps, see what you tracked and finished, move what is left to tomorrow, and pick tomorrow's top 3
  • Fill in the gaps: the parts of the day no timer covered, with what they probably were: a meeting from your Google Calendar, the apps you used (desktop app tracking), or just "not tracked". The project is guessed from your history (which project you usually track while that app is in front). Pick a project or task and Add, or Skip. Also on the Timesheet for any day of the week
  • Time added this way works offline like everything else

Google Calendar

  • "Sync now" no longer fails with "Google Calendar did not answer" on the first sync, or after about three weeks without one (Google only reports changes of the last ~20 days; timedesk now reads its events in full when needed)
  • Problems with Google show Google's reason in the server log
  • An empty GOOGLE_REDIRECT_URI= line in .env no longer stops the API from starting
  • scripts/setup-google-calendar.sh walks you through creating the Google keys

Linux

  • The dock and taskbar show the timedesk logo instead of a generic gear icon. The AppImage adds itself to the app menu

Works offline

  • Fixed: starting a timer, losing the internet and pressing Stop did not stop the timer. Every change (timer start and stop, tasks, projects) now happens on screen at once, is kept on this device, and goes to the server in order when there is a connection. Stop records the moment you pressed it, not when the internet came back
  • Changes survive a reload or a restart while offline. The top bar shows "Offline · 2 changes waiting" or "Saving..."; click it to try again
  • The app opens without a connection: the web app keeps its files on the device, and both the web and the desktop app remember who is signed in, so an offline start no longer sends you to the sign-in page
  • Several windows of the app (the desktop app's floating timer and quick add, two browser tabs) share the same list of waiting changes
  • The server accepts the same change twice without doing it twice, so a retry after a dropped connection is always safe. A device clock that is a little off is corrected instead of refused
  • Signing out first sends what is waiting (for a few seconds); anything left is kept for that person and sent when they sign in again on this device

Multitasking

  • Track two (or more) tasks at once: the timer menu in the top bar has "Also track" next to "Switch to". Each running timer is listed with its own Stop, plus Stop all
  • The time they overlap is shared between them in every total (an hour with two timers counts 30 minutes for each), so your day always adds up to the clock. Reports, timesheet, dashboard, weekly review, the floating timer and Tempo all count it this way
  • Tempo can start a timer alongside the running one, says which timers are running, and stops one by name or all of them

Project colours

  • Twelve preset colours instead of five, and any colour you like: a colour picker or a hex code such as #ff6600 (for a client's brand colour). Existing projects keep their colour

Tempo asks before it acts

  • Deleting a task, a project or a calendar event, and adding or changing calendar events, now shows an approval card in the chat: Allow or Don't allow. Nothing happens until you choose
  • When a request is unclear (two tasks with similar names), Tempo asks which one you mean with clickable choices instead of guessing
  • Failed actions are shown as failed (before, "Deleted a task" could show a tick when nothing was found); errors from the AI provider (wrong key, rate limit, model gone) say what happened, with Try again
  • A chat is saved even when you leave it while Tempo is answering. Offline, the chat says it needs a connection

Stability and speed

  • Opens at once from what this device has, instead of waiting for the server to wake up; pages load in the background so the first click is instant; the layout and dashboard no longer redraw every second while a timer runs
  • One message bar on every page for errors, with a close button (before, errors only showed on the dashboard and never went away). A page that crashes shows its error in place while the sidebar keeps working
  • Many smaller fixes found by a review of the whole app: see the commit for the full list

Focus guard (desktop)

  • Settings, Desktop, Focus guard: an on/off switch (off by default), your lists of distracting apps (for example Discord, Steam) and sites (words in the browser tab title, for example YouTube, reddit.com), with one-click suggestions, and how long a distraction may last before the nudge (10 seconds to 2 minutes)
  • While a timer runs, the desktop app checks which program is in front every 5 seconds. When a listed app or site stays in front past the delay you get a notification ("Back to Write docs?"), and again every 2 minutes if it goes on. A quick look is counted but not nudged
  • The floating timer turns orange and shows "YouTube 0:42 · back to Write docs?" in every style
  • Rests during Pomodoro breaks (when the Pomodoro style is chosen); time away from the computer counts as away, not distracted
  • Each finished session (a minute or longer) is saved to your account: focused and distracted time, nudges, and which of your listed names took time. Window titles are matched on your computer and never saved or sent
  • Dashboard: a Focus card with today's and the last 7 days' focus score, interruptions and the biggest distraction, live while a session runs
  • Tempo's daily summary and weekly review include your focus score and top distractions
  • Included in the JSON export, deleted with the account. API: POST/GET/DELETE /focus/sessions, GET /focus/summary

Faster start

  • The web app is split per page: the first screen now downloads about 583 KB of JavaScript (198 KB compressed) instead of 1.5 MB (458 KB). Charts, the Tempo chat and the calendar load when you open them. Same for the desktop app's built-in interface
  • After a new version is deployed, an open tab that asks for an old page file reloads once instead of showing an error

Tempo

  • Plan my day: Tempo orders your open tasks by what needs attention (overdue, due today, started, high priority), fits them around your Google Calendar events and your daily goal, and proposes time blocks from the current time
  • Daily summary: time tracked by project compared with the day before, tasks finished, what is still due, your daily goal and the apps you used most
  • Weekly review: the week compared with the one before, best day, days the goal was met, wins, what carries over, and the reflection you wrote, plus your plan from the week before
  • One click from the dashboard (the card highlights the one that fits the time of day), from Ctrl+K, and from the Weekly review page
  • Tempo now knows your own time zone, so "today" and "tomorrow" are right even late at night. Before, it used the server's clock (UTC)
  • The numbers come from exact calculations on your data; the AI only writes them up. Window titles from app tracking are never sent to the AI provider, only app names and totals

Weekly review

  • Pick any week (Monday to Sunday) with the arrows
  • Fixed: "Wins" listed every task you had ever finished; it now lists only tasks finished in that week (tasks now remember when they were finished)
  • Fixed: "Save review" did not save anything. Your reflection is now stored with your account, per week

Your data

  • Settings, Account: download everything as JSON (projects, tasks, time, reviews, settings, Tempo chats and memories, app activity; no keys or tokens)
  • Download tracked time as a CSV for Excel or Google Sheets
  • Delete your account and all its data, after typing your username and password

Other

  • The desktop app card in the sidebar showed version 0.1.0; it now shows the current version

Install

  • Windows: download timedesk-Setup-0.4.0.exe and run it. Until the installer is code-signed, Windows may say "Unknown publisher": choose More info, then Run anyway.
  • Linux (Ubuntu, Debian, Mint): sudo apt install ./timedesk_0.4.0_amd64.deb
  • Linux (any distro): chmod +x timedesk-0.4.0.AppImage && ./timedesk-0.4.0.AppImage

Installed copies check this page for newer versions and update themselves (Windows and AppImage). A .deb is updated by installing the newer .deb.

Verify a download with SHA256SUMS.txt.