Manual WakaTime tracker — send heartbeats with a live TUI
Project description
mwt — Manual WakaTime Tracker
A CLI tool for manually sending WakaTime heartbeats.
Fire up a live TUI, track a project, and let it heartbeat every minute.
Supports the official WakaTime API as well as compatible servers like Hackatime.
Install
pip install mwt
Quick start
mwt start my-project
A fullscreen TUI opens showing:
- Elapsed time
- Heartbeats sent
- Last heartbeat timing
- Live status
Press q or Ctrl+C to stop.
Commands
| Command | Description |
|---|---|
mwt start <project> |
Start tracking a project |
mwt start |
Interactive picker — choose from recent projects |
mwt projects |
List recently tracked projects |
mwt config |
Show API key/URL status |
mwt |
Show help |
Configuration
The API key and URL are read from (in order of priority):
- Environment variables:
WAKATIME_API_KEY,WAKATIME_API_URL - The standard WakaTime config file:
~/.wakatime.cfg
Project history is stored at %APPDATA%/mwt/projects.json (Windows) or ~/.config/mwt/projects.json (Linux/macOS).
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file manualwakatime-0.1.0.tar.gz.
File metadata
- Download URL: manualwakatime-0.1.0.tar.gz
- Upload date:
- Size: 6.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5056b26fe8d5172911b48f9eb2387740fca2138762d116a0a0d4408f0746c5ed
|
|
| MD5 |
8492acbd7cfe321618c2843174f5b133
|
|
| BLAKE2b-256 |
3329aaa4fd812889394f30c5a9f1ef3397aa1718ddf194c0053753bfa3f74ea1
|
File details
Details for the file manualwakatime-0.1.0-py3-none-any.whl.
File metadata
- Download URL: manualwakatime-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ecbe19acdc716b2e155fc8946e1470448ac18cdf50109ca97572d282c9ac35b4
|
|
| MD5 |
4213de3ba1edb72651bd249a193daa29
|
|
| BLAKE2b-256 |
d0e5a8581e4e77e45639380f0980240f7aceacd1a997c32b6ba84bb55a5270ea
|
