Repository navigation
HAI Timer Calculator Automator v1.0
馃帀 Initial Public Release
HAI Timer Calculator Automator is a tool designed to automate the collection of Handshake AI task data and payment information while generating detailed CSV exports and Excel earnings trackers.
Features
Automated Handshake AI Task Scraping
-
Scrapes task history directly from Handshake AI.
-
Filters tasks by a user-specified date range.
-
Exports task information into a CSV file.
-
Captures:
- Task ID
- Task Status
- Last Worked On Date
- Total Time
- Project Name
- Project Pay Rate
- Handshake Email
Automated Payment Tracking
-
Scrapes weekly payment information directly from Handshake AI.
-
Retrieves:
- Handshake Calculated Paid Minutes
- Weekly Earnings
- Project-Level Payment Data
-
Supports automatic payment summary generation for selected date ranges.
Excel Earnings Tracker
-
Automatically generates a professional Excel earnings tracker.
-
Calculates:
- Paid Minutes
- Expected Earnings
- Weekly Summaries
- Monthly Summaries
-
Includes visual charts comparing:
- Expected Earnings
- Handshake Paid Earnings
-
Supports updating existing tracker files without creating duplicate tasks.
-
Automatically detects and skips duplicate Task IDs.
Task Type Management
- Built-in task type database with configurable time caps.
- Dropdown-based task categorization.
- Automatic earnings calculations based on project pay rates and task caps.
UCR Automatic Login Support
- Supports automatic UCR Google authentication.
- Supports manual login mode for all users.
- Automatic retry handling for login failures.
- Handles Google and UCR authentication flows.
Cross-Platform Support
- Windows
- macOS
- Linux
PyInstaller Packaging Support
- Build standalone executables using PyInstaller.
- End users do not need Python installed.
- Includes build scripts for Windows, macOS, and Linux.
Improvements
- Cleaner chart generation and formatting.
- Weekly and monthly earnings comparison charts.
- Automatic summary sheet regeneration when trackers are updated.
- Improved error handling and recovery.
- Better Selenium timeout handling.
- Improved project matching logic.
- Improved payment scraping reliability.
Requirements
- Google Chrome installed.
- Internet connection.
- Handshake AI account access.
Known Limitations
- Handshake AI UI changes may require scraper updates.
- Chrome must be installed on the system.
- macOS users may need to manually approve unsigned executables.
Thank You
Thank you for using HAI Timer Calculator Automator. Feedback, bug reports, and feature requests are always welcome.