Ziit
<p align="center"> <img src="https://github.com/user-attachments/assets/bc6a1efd-2a7a-473a-8f09-ae75cafeba84"/> </p> <h3 align="center"> The Swiss army knife of code time tracking. </h3> <div align="center"> <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> </div> <br> [](https://status.ziit.app)  > [!IMPORTANT] > Upvote Ziit on [AlternativeTo](https://alternativeto.net/software/ziit/about/), [ProductHunt](https://www.producthunt.com/posts/ziit), [PeerPush](https://peerpush.net/p/ziit) to help me promote it. <details> <summary><kbd>Star History</kbd></summary> <a href="https://starchart.cc/0PandaDEV/Ziit"> <picture> <img width="100%" src="https://starchart.cc/0PandaDEV/ziit.svg?variant=adaptive"> </picture> </a> </details> ## 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](https://docs.ziit.app/deploy) 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)](https://docs.ziit.app/extensions/vscode) - [JetBrains](https://plugins.jetbrains.com/plugin/27391-ziit) For more details on how to setup the IDE extensions checkout the [docs](https://docs.ziit.app/extensions). ## Development ### Prerequisites - [Bun](https://bun.sh/) - [TimescaleDB](https://docs.timescale.com/self-hosted/latest/install/installation-docker/) ### Setup 1. **Install dependencies:** ```bash bun i ``` 2. **Database Migrations:** Apply database schema changes. ```bash bunx prisma migrate dev ``` 3. **Set the environment variables:** It is imporatnt that you make a `.env` using the [.env.example](https://github.com/0PandaDEV/Ziit/blob/main/.env.example) as a template and set the correct values. All the instructions needed are in the example file. 4. **Run the development server:** The server will start on `http://localhost:3000`. ```bash bun dev ```