Time Bullet

Time Bullet Plugin for Obsidian

Automatically add timestamps to your lists with minimal effort 🕒

Features

• Auto-timestamp task lists: Converts -[t] to - [HH:mm] with current time when you press Space
• Timestamp continuity: When pressing Enter on a timestamped list item, the new line automatically includes the current time
• 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]
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

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 true) - Use UTC time when creating a timestamp. If false, time will be local to your machine.

Installation

From Obsidian Community Plugins

1. Open Obsidian
2. Go to Settings → Community plugins
3. Disable Safe mode if necessary
4. Click Browse and search for "Time Bullet"
5. Install the plugin and enable it

Manual Installation

1. Download the latest release from the releases page
2. Extract the zip file to your Obsidian plugins folder: {vault}/.obsidian/plugins/
3. Reload Obsidian
4. Enable the plugin in Settings → Community plugins

Support

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

• Open an issue on GitHub
• Check the existing issues before creating a new one

Contributing

Contributions are welcome! If you'd like to contribute:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.