Skip to content

devonthesofa/logseq-logbook-timeline

Repository files navigation

Logbook Timeline Plugin for Logseq

A plugin that provides a chronological and summarized view of all Logbook activity on the current page. Perfect for seeing where you spend your time without navigating through all blocks.

Logbook Timeline Main UI

Installation:

  1. Open Logseq.
  2. Go to Settings > Plugins > Marketplace.
  3. Search for "Logbook Timeline" and click Install.

Plugin Icon

Logbook Timeline Icon

Features

  • Visual Timeline: Chronological list of all your CLOCK entries with status dots and lines.
  • LIVE Support: If you are currently timing a task, it appears with a pulsing red dot and updates in real-time.
  • Smart Deduplication: Prevents duplicates if the same block is referenced in multiple places.
  • Tag Filtering: Click any tag (#tag) or group to filter the list instantly.
  • Configurable Font Size: Adjust the text size from the plugin settings.

UI and Controls

At the top of the sidebar you will find control buttons:

  1. All: Clears all filters and shows all activity.
  2. Grouped: Filters to show only blocks that have a category (tags or group).
  3. Sum (Aggregate):
    • When active, merges identical entries into a single line.
    • Shows the total accumulated time for each task.
    • Displays the number of sessions performed (Σ).
  4. Stats: Shows or hides the summary card at the top, which includes the PAGE TOTAL and breakdown by category.

Time Organization

The plugin uses a priority hierarchy to group time:

  1. Aggregators (📁): Blocks containing the /group command (or your custom command). All time from child blocks will be grouped under this name.
  2. Tags (#): If a block has Logseq tags or referenced pages, the first one is used as the category.
  3. Others (⚪): Time that does not belong to any group and has no tags.

Configuration

You can adjust these values from Settings > Plugins > Logbook Timeline:

  • Grouping Command: The command (default /group) to mark blocks as hierarchical aggregators.
  • Min Duration: Minimum time in seconds for a log entry to appear in the list (default 60s).
  • Base Font Size: The font size of the entire plugin interface.

☕ Support This Project

If you find this plugin helpful, consider supporting its development:


Built with ❤️ for Logseq users who want to master their time.

About

A logseq plugin to visualize logbook entries of the current page as a timeline in the sidebar.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors