Disclaimer: HermesX is an independent, unofficial companion application for ZeusX users. It is not affiliated with, endorsed by, or connected to ISGUS or ZeusX in any way.
Another Disclaimer: This project is not and will never be integrated with ZeusX. This means that HermesX will not be able to react to changes made directly in ZeusX.
That means that manual bookings outside of HermesX are possible but will not be reflected in the HermesX state.
HermesX is a modern, intelligent desktop assistant that helps you maintain a healthy work-life balance by reminding you to track your work hours in ZeusX. It provides smart notifications and monitoring to ensure you never forget to log your time entries.
⚠️ Testing Phase: HermesX is currently under development. Testing builds are available from our CI pipeline.
Latest test builds are available as releases:
- Click on the latest release
- Scroll down to the "Assets" section
- Download the appropriate package for your system:
- 🍎 macOS:
HermesX-<version>-arm64.dmg - 🪟 Windows:
HermesX-<version>-Setup.exe
- 🍎 macOS:
HermesX serves as a helpful companion for ZeusX users by:
- Reminding you to start and stop your time tracking
- Suggesting breaks based on your work patterns
- Monitoring system activity to detect work states
- Providing a seamless interface for quick time entries
-
Smart Time Tracking
- Automatic work state detection:
- Work mode detection based on system activity
- Intelligent break suggestions:
- Configurable short and long break reminders
- Auto break suggestions after periods of inactivity
- Customizable break durations
- Flexible schedule management:
- Configurable work days and hours
- Customizable start times and work durations
- Automatic work state detection:
-
Intelligent Notifications
- Context-aware notifications:
- Quiet mode for focused work periods
- Context aware notifications based on system activity
- Intelligent notification suppression:
- Automatic detection of meetings and calls
- Gaming mode detection and suppression
- Customizable notification settings:
- Short and long break reminders
- Inactivity thresholds
- Break management:
- Configurable break durations
- Smart break suggestions based on activity
- Context-aware notifications:
-
System Integration & Security
- Native system tray integration
- Secure credential management
see Usage
Access settings through the system tray icon to customize:
- Work schedule and days
- Break duration and frequency
- Notification preferences
- Activity thresholds
- Node.js 18 or higher
- Yarn package manager
- macOS, Windows, or Linux operating system
-
Clone the repository:
git clone https://github.com/florianbeisel/hermesx.git cd hermesx -
Install dependencies:
yarn install
-
Start the development server:
yarn start
-
Build for production:
yarn make
- Advanced activity detection
- Calendar integration (i.e. for holidays, working days, etc.)
- Advanced notification suppression (i.e. for phone calls, meetings, etc. and gaming)
- Configurable amount of flexibility (i.e. less strict work hours)
- Configurable amount of breaks
- Configurable work weeks
- Configurable break duration
- Configurable break frequency
- Configurable work hours
- Configurable work days
We welcome contributions! If you'd like to help improve HermesX, please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with Electron
- Powered by TypeScript
- Uses Vite for blazing fast development
- Icon design by Midjourney
For bug reports, please include:
- Operating system and version
- Steps to reproduce
- Expected vs actual behavior
- Screenshots if applicable
For feature requests, please describe:
- The feature and its purpose
- The problem it solves
- Any additional context
Made with ❤️ by Florian Beisel