Keyboard Stats Tracker

A desktop application that tracks and displays keyboard usage statistics, running in a Docker container with system tray integration.

Project Structure

├── src/                    # Application source code
├── tests/                  # Test files
├── scripts/                # Build and development scripts
│   ├── build.sh           # Docker image build script
│   ├── run.sh             # Docker run script
│   └── dev.sh             # Development workflow script
├── build                   # Build wrapper (calls scripts/build.sh)
├── dev                     # Development wrapper (calls scripts/dev.sh)
├── compose.yml             # Docker Compose configuration
├── Dockerfile              # Docker image definition
└── requirements.txt        # Python dependencies

Quick Start

Build the application:

./build

Run the application:

./dev run

Development commands:

./dev help          # Show all available commands
./dev build         # Build Docker image
./dev up            # Start with Docker Compose
./dev down          # Stop Docker Compose
./dev test          # Run tests
./dev logs          # Show application logs
./dev shell         # Open shell in container
./dev clean         # Clean up Docker resources

Requirements

• Docker
• Docker Compose
• X11 display server (for GUI)
• Linux host system with input device access

Features

• System tray integration
• Keyboard event monitoring
• Containerized deployment
• Cross-platform GUI support