https://github.com/stared/xbar-rescuetime-activities
Monitor your RescueTime activities and distractions directly from the macOS menu bar with this xbar plugin.
https://github.com/stared/xbar-rescuetime-activities
menubar-app productivity rescuetime time-tracking xbar xbar-plugin
Last synced: 2 months ago
JSON representation
Monitor your RescueTime activities and distractions directly from the macOS menu bar with this xbar plugin.
- Host: GitHub
- URL: https://github.com/stared/xbar-rescuetime-activities
- Owner: stared
- Created: 2024-11-14T09:25:16.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-11-18T08:59:40.000Z (7 months ago)
- Last Synced: 2025-03-30T10:33:42.352Z (3 months ago)
- Topics: menubar-app, productivity, rescuetime, time-tracking, xbar, xbar-plugin
- Language: Python
- Homepage:
- Size: 157 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-time-tracking - xbar-rescuetime-activities - An xbar plugin for macOS that monitors RescueTime activities and distractions from the menu bar. ([Read more](/details/xbar-rescuetime-activities.md)) `macos` `activity-monitoring` `automation` `plugin` (Automated Time Tracking)
README
# RescueTime Activities - An xbar Plugin
Monitor your RescueTime activities and distractions directly from the macOS menu bar with this xbar plugin.
## Requirements
- macOS 10.15 (Catalina) or later; tested on macOS 14.5 (Sonoma)
- [xbar](https://github.com/matryer/xbar) (formerly BitBar)
- [RescueTime](https://www.rescuetime.com/)
## Installation
1. Install [xbar](https://github.com/matryer/xbar) manually
- or via [Homebrew](https://brew.sh/): `brew install --cask xbar`
2. Open `xbar` and navigate to **xbar > Open Plugin Folder** and copy `rescuetime-activities.3m.py` into the plugin folder
- or `curl https://raw.githubusercontent.com/stared/xbar-rescuetime-activities/refs/heads/main/rescuetime-activities.3m.py -o ~/Library/Application\ Support/xbar/plugins/001-rescuetime-activities.3m.py`
3. Refresh all plugins by selecting **xbar > Refresh All Plugins**
4. Generate a [RescueTime API key](https://www.rescuetime.com/anapi/manage)
5. Open the plugin in xbar preferences via **xbar > Open Plugin** and enter your RescueTime API key
6. (optional) Install `Pillow` to view the daily productivity chart; the plugin will provide specific instructions, e.g., `python3 -m pip install Pillow`
## Notes
Check out my earlier blog post: [ADHD Tech Stack: Auto Time Tracking](https://p.migdal.pl/blog/2020/05/adhd-tech-stack-auto-time-tracking).
This plugin is inspired by the [RescueTime plugin](https://xbarapp.com/docs/plugins/Dev/rescuetime.1h.py.html) by [Paul Traylor](https://github.com/kfdm).
I rewrote it to display a detailed list of activities, rather than just a summary of productive and distractive time.
## TODO
- Add a weekly productivity chart