A powerful time tracking plugin for Obsidian that helps you monitor and analyze your note-taking habits with detailed statistics and beautiful charts.
- Automatic tracking: Seamlessly tracks time spent in Obsidian without manual intervention
- Session management: Records individual study/work sessions with start and end times
- File-level tracking: Monitor time spent on specific notes and files
- Real-time updates: See your current session progress in the status bar
- Beautiful charts: Interactive charts showing daily, weekly, and monthly usage patterns
- Detailed statistics: Comprehensive analytics including total time, average session length, and productivity trends
- Custom date ranges: Filter and analyze data for any time period
- Export capabilities: Export your usage data for further analysis
- Cloud sync: Sync your usage data across multiple devices via SaaS backend
- Local storage: All data is stored locally first, ensuring privacy and offline access
- Automatic backup: Regular data synchronization to prevent data loss
- Cross-platform: Works seamlessly across Windows, macOS, and Linux
- Open Obsidian Settings
- Go to Community Plugins
- Turn off Safe mode
- Click Browse and search for "Obtime"
- Click Install, then Enable
- Download the latest release from GitHub Releases
- Extract the plugin folder to your Obsidian vault's plugins folder
- Enable the plugin in Obsidian Settings > Community Plugins
- Enable tracking: The plugin starts tracking automatically when enabled
- View status: Check the status bar for current session information
- Open dashboard: Use the command palette or click the plugin icon to open the main view
- View your daily, weekly, and monthly usage statistics
- See current session progress and total time today
- Access detailed charts and analytics
- Start/stop tracking manually if needed
- View active session information
- Review historical session data
- Export usage data in various formats
- Share statistics with productivity tools
- Backup your tracking history
Obtime: Open Dashboard- Open the main statistics viewObtime: Start Tracking- Manually start a new sessionObtime: Stop Tracking- End the current sessionObtime: Export Data- Export your usage statistics
- Auto-start tracking: Automatically begin tracking when Obsidian opens
- Session timeout: Set how long to wait before considering a session inactive
- Data retention: Configure how long to keep historical data
- Sync preferences: Choose what data to sync with the cloud
- Local storage only: Keep all data local if preferred
- Data sharing: Control what analytics are shared
- Status bar format: Customize what appears in the status bar
- Chart themes: Choose chart colors and styles
- Notification preferences: Set up alerts and reminders
- Node.js 18.x or higher
- TypeScript knowledge
- Obsidian plugin development experience
# Clone the repository
git clone https://github.com/createitv/obsidian-usage-stats.git
cd obsidian-usage-stats
# Install dependencies
pnpm install
# Start development
pnpm dev# Build for production
pnpm build
# Create plugin package
pnpm packageWe welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with Obsidian Plugin API
- Charts powered by modern web technologies
- Icons from Lucide React
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: Contact via GitHub
See CHANGELOG.md for a complete list of changes and updates.
Made with ❤️ for the Obsidian community