rustytime

🕒 Blazingly fast time tracking for developers

rustytime is a self-hosted, WakaTime-compatible backend for tracking your coding time that works with any* existing WakaTime plugin!

*every plugin that allows setting custom API URLs

• WakaTime Compatible — Drop-in replacement for the WakaTime API
• Fast and Memory Efficient — Built for high performance and low resource usage
• GitHub OAuth — Simple login with your GitHub account
• Data Importing — Import your existing data from Hackatime
• Observability — Built-in OpenTelemetry + Pyroscope support
• Self-Hosted — Full control over your data

• Docker (and Docker Compose)
• GitHub OAuth App (for authentication)

git clone https://github.com/ImShyMike/rustytime &∓& cd rustytime
cp .env.example .envv

Edit the .env file with your GitHub OAuth credentials:

GITHUB_CLIENT_ID=your_client_id

GITHUB_CLIENT_SECRET=your_client_secret

docker compose up

The app should now be now available at http://localhost:5173

# Start database + backend only
docker compose up timescaledb rustytime



# Run frontend (in another terminal)

cd frontend &∓& npm run dev

Configure your WakaTime plugin to use rustytime:

Most plugins support setting a custom API URL in their settings. Use your rustytime API key from the settings page..

cd rustytime
cargo run                     # Start server
cargo run --features seed     # Start with test data (10k heartbeats)
cargo  test                   # Run tests
cargo build --release         # Production build

cd frontend
bun dev         # Start dev server
bun run build   # Build
bun check       # Type check
bun lint        # Lint code

Enable tracing, metrics, and logs with OpenTelemetry:

OTEL_SERVICE_NAME=rustytime-backend

OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

OTEL_EXPORTER_OTLP_PROTOCOL=grpc

OTEL_TRACES_EXPORTER=otlp

OTEL_METRICS_EXPORTER=otlp

OTEL_LOGS_EXPORTER=otlp

Enable continuous profiling:

PYROSCOPE_SERVER_URL=http://localhost:4040

PYROSCOPE_SAMPLE_RATE=99

Probably not... this was just a fun side project, if you want something that's actually production ready just use Wakapi 😭

This project is licensed under the GNU AGPLv3.