github.com/0PandaDEV/Ziit @v1.1.3

The Swiss army knife of code time tracking.

<a href="https://docs.ziit.app">Docs</a>
<span>  •  </span>
<a href="https://ziit.app/stats">Stats</a>
<span>  •  </span>
<a href="https://ziit.app/leaderboard">Leaderboard</a>
<span>  •  </span>
<a href="https://discord.gg/Y7SbYphVw9">Discord</a>

[!IMPORTANT] Upvote Ziit on AlternativeTo, ProductHunt, PeerPush to help me promote it.

Star History

  <img width="100%" src="https://starchart.cc/0PandaDEV/ziit.svg?variant=adaptive">

What is Ziit?

Ziit (pronounced 'tseet') is an open-source, self-hostable alternative to WakaTime. It provides a clean, minimal, and fast dashboard for displaying coding statistics, while ensuring privacy by keeping all data on your own server. Ziit tracks coding activity such as projects, languages, editors, files, branches, operating systems, and time spent coding all presented in a familiar interface inspired by Plausible Analytics.

Features

• Time tracking directly from VS Code to your Ziit instance of choice.
• Filtering using different time ranges.
• Clean & Minimal dashboard showing only the information needed.
• Login with GitHub or Email and Password.
• Import Data from Wakatime or a WakAPI Instance.
• Saves data about your current project, OS, editor, file, language and git branch.
• Badges to embed coding time for a project into a README.
• Public stats page to see information from the whole Ziit instance.
• Public leaderboard to see who has the most coding hours.
• More to come...

How to use Ziit

First setup an instance or sign up on the public one https://ziit.app then install the extension by searching for "Ziit" in your favorite IDE.

Supported IDE's:

• VS Code (Including all forks)
• JetBrains

For more details on how to setup the IDE extensions checkout the docs.

Development

Prerequisites

• Bun
• TimescaleDB

Setup

1. Install dependencies:

bash bun i

1. Database Migrations: Apply database schema changes.

bash bunx prisma migrate dev

1. Set the environment variables: It is imporatnt that you make a .env using the .env.example as a template and set the correct values. All the instructions needed are in the example file.

2. Run the development server: The server will start on http://localhost:3000.

bash bun dev