What is FocusLog?
FocusLog is a background server that logs your desktop activity, calculates your Actions Per Minute (APM), and provides a clean, anonymized timeline of your work on demand. It serves as a data source for personal analytics or AI assistants.
How to use FocusLog?
To use FocusLog, clone the repository, set up a virtual environment, install the required packages, and configure the settings in the config.py file. You can run it manually for testing or set it up as a systemd service for continuous operation.
Key features of FocusLog?
- Activity logging of the currently focused window.
- APM tracking based on keyboard and mouse activity.
- Timeline aggregation for easy reading.
- Two-stage anonymization to protect personal information.
- Title sanitization for cleaner logs.
- Configurable settings and reliable operation as a systemd service.
Use cases of FocusLog?
- Tracking productivity by analyzing desktop activity.
- Providing data for personal analytics or AI assistants.
- Monitoring user engagement through APM metrics.
FAQ from FocusLog?
- Is FocusLog compatible with all operating systems?
No, FocusLog is designed specifically for Linux desktop environments running on the X11 display server.
- How does FocusLog ensure user privacy?
FocusLog uses a two-stage anonymization process to remove sensitive information from logs.
- Can I run FocusLog as a background service?
Yes, it is recommended to run FocusLog as a systemd service for reliable background operation.
Server Config
{
"mcpServers": {
"focuslog": {
"command": "git",
"args": [
"clone",
"https://github.com/DragonsWho/FocusLog"
],
"env": {}
}
}
}