---

Important

In order to display your statistics you need to host this API yourself, for this I recommend using Cloudflare Workers

🌐 Hosting with Cloudflare Workers

1. Clone this repository git clone https://github.com/IgorKowalczyk/wakatime-hours
2. Install dependencies pnpm install
3. Edit wrangler.jsonc file and set your name, routes or other settings if needed
4. Run wrangler dev to start the project in development mode or wrangler deploy to deploy the project to Cloudflare Workers
5. Run pnpm wrangler secret put WAKATIME_API_KEY and paste your Wakatime API Key, you can get it here
6. Visit https://YOUR-DEPLOY/api/badge in your browser

Note

If you wish to host this API on a different platform, refer to the Hono documentation for deployment instructions. You may need to modify the code to work with your hosting provider.

🔩 Local development

1. Clone this repository git clone https://github.com/IgorKowalczyk/wakatime-hours
2. Install dependencies pnpm install
3. Create new file named .dev.vars. Remember - the file is super secret, better to not share it!
4. In .dev.vars file set this values (.env file syntax):
   • WAKATIME_API_KEY - Your Wakatime API Key, you can get it here
5. Run pnpm dev to start the project in development mode
6. Visit http://localhost:8787/api/badge in your browser

🚀 Getting Wakatime API key

1. Go to Wakatime and login to your account
2. Go to API Keys page and copy your API Key. This key is super secret, better to not share it.
3. Paste your API Key to .dev.vars file or add it as environment variable on your hosting

🗜️ API Usage

GET https://YOUR-DEPLOY/api/badge?style=${style}&color=${color}&label=${label}

Parameter	Type	Description	Available values	Default value
style	string	Optional. The style of the badge	Available styles	flat
color	string	Optional. The color of the badge	Available colors	blue
label	string	Optional. The label of the badge	Any string	Wakatime

🖼️ Available styles

Note

The default style is flat

Style	Example	Usage
flat		style=flat
flat-square		style=flat-square
for-the-badge		style=for-the-badge
plastic		style=plastic
social		style=social

Note

To apply the style, add to the URL ?style=YOUR-STYLE, if you use other parameters you can use &style=YOUR-STYLE

🎨 Custom colors

Note

The default color is blue

Color	Example	Usage	Label Color	Label usage
brightgreen		color=brightgreen		labelColor=brightgreen
green		color=green		labelColor=green
yellow		color=yellow		labelColor=yellow
yellowgreen		color=yellowgreen		labelColor=yellowgreen
orange		color=orange		labelColor=orange
red		color=red		labelColor=red
blue		color=blue		labelColor=blue
grey		color=grey		labelColor=grey
lightgrey		color=lightgrey		labelColor=lightgrey
blueviolet		color=blueviolet		labelColor=blueviolet
ff69b4		color=ff69b4		labelColor=ff69b4

Note

To apply the style, add to the URL ?color=YOUR-COLOR, if you use other parameters you can use &color=YOUR-COLOR

Warning

HEX colors should be used without # symbol prefix.

📝 Custom text

You can overwrite default Wakatime text with your own label.

Note

Replace whitespace with + character in multi-word labels.

![Wakatime Hours](https://YOUR-DEPLOY/api/badge?label=Your+own+label)

📊 Getting Wakatime API Key

1. Go to Wakatime and login to your account
2. Go to API Keys page and copy your API Key
3. Paste your API Key to .env file or add it as environment variable on your hosting
4. Restart your API if needed

Important

Wakatime API Key is super secret, better to not share it. If you share it, anyone can use your API Key to get or modify your statistics.

⁉️ Issues

If you come across any errors or have suggestions for improvements, please create a new issue here and describe it clearly.

📥 Pull Requests

When submitting a pull request, please follow these steps:

• Clone this repository https://github.com/IgorKowalczyk/wakatime-hours.git
• Create a branch from main and give it a meaningful name (e.g. my-awesome-new-feature).
• Open a pull request on GitHub and clearly describe the feature or fix you are proposing.

📋 License

This project is licensed under the MIT. See the LICENSE file for details