Time Bullet Plugin for Obsidian

Automatically add timestamps to your lists with minimal effort 🕒

Maintained fork of pedrogdn/obsidian-time-bullet-plugin. The original project is no longer actively maintained. This repository keeps the same plugin id (time-bullet) so it can replace an existing install.

Features

• Auto-timestamp task lists: Converts -[t] to - [HH:mm] with current time when you press Space (also works after an existing list marker: type -[t] on a - line)
• Timestamp continuity: When pressing Enter on a timestamped list item, the new line automatically includes the current time
• Drop back to a plain list: Enter on an empty time bullet (- [HH:mm] with nothing typed) strips the timestamp and leaves a normal - item
• Toggle timestamps: Add or remove timestamps from any line with a customizable hotkey
• Minimal interference: Works naturally within your existing workflow
• No configuration needed: Simple, intuitive functionality right out of the box

Usage

Creating a timestamped list

1. Type -[t] (on an empty line, or after an existing - / * / + list marker)
2. Press the Space key
3. The text becomes - [{{time_stamp}}] with the current time formatted based on your settings (default is HH:mm).
4. Continue writing your note

Continuing a timestamped list

1. Press Enter at the end of a line that starts with - [{{time_stamp}}]
2. A new list item with the current time is automatically created
3. Continue with your notes

Leaving time-bullet mode

1. Press Enter on an empty time bullet (the line is only - [HH:mm] , nothing after the timestamp)
2. The timestamp is removed and the line becomes a normal list item (- )
3. Press Enter again on that empty - to outdent or leave the list, using Obsidian's usual list behaviour

Toggle time bullets

1. Place your cursor on any line
2. Use the hotkey you've assigned to "Toggle time bullet" (set in Settings → Hotkeys)
3. The command will:
   • Add a timestamp to regular bullets: - becomes - [HH:mm]
   • Remove timestamps from time bullets: - [HH:mm] becomes -
   • Add both bullet and timestamp to plain text lines

Use Cases

• Meeting notes: Track when different points were discussed
• Daily logs: Document when you completed different tasks
• Research notes: Record the time of observations or findings
• Time tracking: Keep a simple record of activities throughout your day

Settings

• Time format: (default is HH:mm) - Customize your time format using Dayjs formatting found on the dayjs documentation
• Use UTC: (default is false) - Off uses your computer's local time. Turn on only if you want UTC (8 hours behind China Standard Time).

Installation

This fork is not the Community Plugins listing (that still points at the original). Install it manually or with BRAT.

BRAT

1. Install BRAT
2. Add this repository: kakamisamas/obsidian-time-bullet-plugin
3. Enable Time Bullet in Community plugins

Manual installation

1. Download main.js and manifest.json from the latest release
2. Put them in {vault}/.obsidian/plugins/time-bullet/
3. Reload Obsidian and enable the plugin

If you already had the original Time Bullet installed, replace the files in that same folder. Settings are preserved.

Changelog

1.4.2

• Typing -[t] then Space on an existing list item (- -[t]) expands into a time bullet, same as at the start of a line.

1.4.1

• After dropping to a plain - list item, typing no longer wraps a timestamp back onto the line (Easy Typing whole-line rewrite).
• Enter on an empty time bullet keeps the caret on that same line.

1.4.0

• Enter on an empty time bullet (- [HH:mm] with no content) now becomes a plain list item (- ) instead of outdenting or leaving the list.
• A second Enter on that empty plain bullet uses Obsidian / Outliner as usual.

1.3.1

• Fix timestamps duplicating after Enter (- [HH:mm] A[HH:mm] text).
• Caused when Outliner (Better Enter) puts the caret inside - [HH:mm], then Easy Typing rewrites the line and Time Bullet wraps a second stamp.
• Skip inserts that are already a time bullet, and move the caret after the timestamp prefix.

Support

If you encounter any issues or have feature requests, please:

• Open an issue on this repository

Contributing

Contributions are welcome. Open a pull request against this repository.

License

MIT. Original work by pedrogdn; this fork is maintained by kakamisamas. See LICENSE.