mrusme/kopi

Kopi

LICENSE](https://img.shields.io/static/v1?label=SEGV%20LICENSE&message=1.1&labelColor=0060A8&color=ffffff)](https://xn--gckvb8fzb.com/segv/)

<img src="https://xn--gckvb8fzb.com/images/chatroom.png" width="275"

From Malay kopi (“coffee”) and Hokkien 咖啡 (ko-pi); the latter is also derived from the former.\ -- Wiktionary

Kopi is a command-line (CLI) coffee journal (or habit tracker), designed for coffee enthusiasts. It lets you track coffee beans, equipment usage, brewing methods, and individual cups.

The tracked data offers insights into bean and roast preferences, caffeine and dairy consumption, and equipment usage patterns. This helps users refine their coffee choices while managing caffeine intake for a more enjoyable and responsible experience.

Kopi focuses on meticulously tracking every step of the coffee preparation process. Unlike standard coffee or caffeine tracking apps, it requires more detailed input to function effectively. If you only want to track the cups of coffee you drink without monitoring the beans/roasts and the preparation methods used, Kopi may not be the best fit for you. Think of Kopi as a coffee journal that lets you rate individual roasts and analyze how different roasts, brewing methods, and drink types influence your preferences.

Kopi stores everything locally and does not send any data to third-party services unless explicitly mentioned before an operation (e.g. requesting current exchange rates from the ECB, for price input/conversions of individual coffee bags). Kopi does not employ analytics libraries/services.

Status

Kopi is still in its early stages. Some features might not be working as expected and others might very well be missing. If you depend on your coffee journal, do not use Kopi at this stage, as things might change and, in the worst case, randomly break. If you're feeling adventurous or you're looking to contribute to the project, please find all the relevant information down below.

To do

• [ ] Update/edit ...
• [ ] equipment
• [ ] coffee
• [ ] bag
• [ ] cup
• [ ] Decommission equipment

• [ ] Close bag
• [ ] Ask to close bag when finished (based on consumed cups)
• [ ] (TODO)

Install

From Release

Download the latest release and unpack it:

▲ tar -xzf ./kopi_*.tar.gz

The binary kopi can be moved wherever you please.