Skip to content

Releases: linconvidal/timegrain-obsidian-plugin

1.0.0

24 Dec 21:54

Choose a tag to compare

Timegrain v1.0.0

Initial Release

Harvest your time, grain by grain

Timegrain is a Pomodoro timer plugin for Obsidian that integrates deeply with your notes. Track time on tasks, log how you feel, and gain insights into your productivity patterns—all within your vault.


Features

Timer

  • Start/pause/resume/cancel/complete timer sessions
  • Pomodoro tracking with configurable duration (default 25 min)
  • Audio notification on pomodoro completion
  • Status bar integration showing current task and time
  • Automatic session recovery on startup

Task Management

  • Create tasks with title, status, estimation, expected energy, and category
  • Plan your day: batch-select tasks to move to "Today" status
  • Fuzzy search to quickly find and start any task
  • Auto-rollover of stale "Today" tasks to "This Week"
  • Multiple task statuses: today, in progress, this week, this month, backlog, done, archived, on hold, needs review

Energy Tracking

  • Rate how you feel (5 levels) and perceived effort (0-10) after each session
  • Tracks hour-of-day and day-of-week patterns
  • Analyzes peak productivity times

Daily Log & Analytics

  • Interactive calendar with activity heat map
  • Timeline visualization of work sessions
  • Color-coded by task
  • Navigate to any date to review history
  • Track daily goals and streaks

Data Format

  • Tasks: Markdown files with YAML frontmatter (/tasks/.md)
  • Sessions: Stored in timer_sessions/ folder
  • Fully portable and searchable within Obsidian

Commands

  • Start timer with current note — Start timing the active file
  • Start timer: Select task... — Fuzzy search to pick a task
  • Pause/resume timer — Toggle timer pause
  • Complete timer session — Finish and log how you feel
  • Cancel timer — Cancel without completing
  • Open timer panel — Show timer in sidebar
  • Open daily log — Calendar and timeline view
  • Create new task — Task creation form
  • Plan your day — Batch-select tasks for today

Requirements

  • Obsidian v1.5.0 or higher
  • Works on desktop and mobile

Links