timer-coffee

KO | EN

gitlite — search

#python #javascript #react #golang #android #html #video #go #ios #rust #hacktoberfest #css

★ 93 Open GitHub ↗

Timer.Coffee app

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Timer.Coffee ☕

[<img src="https://www.timer.coffee/assets/images/app-store-badge.webp" width="27%">](https://apple.co/42WfmtI) [<img src="https://www.timer.coffee/assets/images/google-play-badge.webp" width="30%">](https://play.google.com/store/apps/details?id=com.coffee.timer) [<img src="https://i.imgur.com/mb4ryMc.png" width="30%">](https://app.timer.coffee)

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://raw.githubusercontent.com/antonkarliner/timer-coffee/main/LICENSE)
[![Pull Requests Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/antonkarliner/timer-coffee/issues)
[![Last Commit](https://img.shields.io/github/last-commit/antonkarliner/timer-coffee.svg)](https://github.com/antonkarliner/timer-coffee/commits/main)
[![Made with Flutter](https://img.shields.io/badge/made%20with-Flutter-46D1FD.svg)](https://raw.githubusercontent.com/antonkarliner/timer-coffee/main/)
[![Localization](https://img.shields.io/badge/i18n-22%20languages-orange.svg)](https://raw.githubusercontent.com/antonkarliner/timer-coffee/main/)
[![Buy Me A Coffee](https://img.shields.io/badge/support-Buy%20Me%20a%20Coffee-yellow.svg)](https://buymeacoffee.com/timercoffee)
[![GitHub Stars](https://img.shields.io/github/stars/antonkarliner/timer-coffee.svg)](https://github.com/antonkarliner/timer-coffee/stargazers)

> Free & open‑source coffee brewing timer and calculator for iOS, Android, and the Web.

**Timer.Coffee** helps you brew consistently great coffee. Explore **40+ recipes** across **30 brewing methods**, follow clear step‑by‑step timers, log your beans and brews, and fine‑tune every cup. Completely free—optional donations keep development going, but never gate features.

---

## Table of Contents

- [Features](#features)
- [Brewing Methods](#brewing-methods)
- [Languages](#languages)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [Translation](#translation)
- [Support Development](#support-development)
- [License](#license)

---

## Features

- **Create & Share Recipes** – Build your own brewing recipes and share them with friends and the community.
- **40+ Recipes** – Guided timers with detailed steps for popular brewing methods (see list below).
- **Coffee Calculator** – Adjust coffee or water amounts to brew any volume.
- **Favorites** – Mark and quickly access your preferred recipes.
- **Brew Diary** – Log brews automatically during a timer session or add entries manually. Add tasting notes and track every cup.
- **Custom Grind Size per Recipe** – Save your grind setting (e.g. "Comandante C40 25 clicks") directly on the recipe so it's always there when you need it.
- **Bean Management** – Scan coffee bag labels to save beans effortlessly, log origin, roaster, farm info, and remaining weight. Inventory auto-updates after each brew.
- **Background Brewing** – The timer keeps running accurately when you switch apps or lock your screen.
- **Live Activities & Live Updates** – On iPhone, your brew step and countdown appear on the Lock Screen and in the Dynamic Island. On Android, a persistent notification tracks your brew in real time.
- **Pulse** – A live view of what other Timer.Coffee users around the world are brewing right now.
- **Device Sync** – Recipes, beans, and brews stay in sync across iOS, Android, and Web.
- **Step Alerts** – Audio chimes or vibration alerts for each brewing step.
- **Dark Mode** – Brew comfortably any time of day.
- **Multilingual** – Available in 22 languages (see below).

---

## Brewing Methods

Timer.Coffee supports 30 brewing methods and variations:

Aeropress · April Brewer · Batch Brew · Bee House Dripper · Cafec Flower Dripper · Ceado Hoop Brewer · Cezve · Chemex · Clever Dripper · Cupping · Espro Bloom Brewer · Espresso · French Press · Kalita Wave · **Melitta** Cone · Moka Pot · **Neapolitan** Flip Pot · Orea Brewer · Origami Dripper · Oxo Rapid Brewer · Phin Filter · Pulsar · Siphon Brewer · Hario Switch · Timemore B75 · Tricolate · UFO Dripper · Hario V60 · Weber Workshops BIRD · Wilfa Svart Pour Over.

> Have a favorite method that’s missing? Open an issue with the details and we’ll add it.

---

## Languages

Timer.Coffee currently supports **22** languages:

Arabic (العربية) · Chinese (中文) · English · Spanish (Español) · Portuguese (Português) · German (Deutsch) · Greek (Ελληνικά) · French (Français) · Russian (Русский) · Polish (Polski) · Indonesian (Bahasa Indonesia) · Turkish (Türkçe) · Italian (Italiano) · Dutch (Nederlands) · Romanian (Română) · Ukrainian (Українська) · Finnish (suomi) · Japanese (日本語) · Farsi (فارسى) · Korean (한국어) · Croatian (hrvatski) · Norwegian (Norsk bokmål)

---

## Installation

**iOS:** [Download on the App Store](https://apps.apple.com/app/apple-store/id6449322787)  
**Android:** [Get it on Google Play](https://play.google.com/store/apps/details?id=com.coffee.timer)  
**Web:** Use the web app at [app.timer.coffee](https://app.timer.coffee/)

---

## Usage

1. Select a brewing method and recipe.  
2. Optionally adjust coffee or water amounts using the calculator.  
3. Start the timer and follow the guided steps (audio chimes or vibration alerts).
4. Log beans, add tasting notes, and track brews in the diary (entries are logged automatically or added manually).  
5. Create your own recipes or share existing ones.

---

## Contributing

Contributions of all kinds are welcome — recipes, features, and bug fixes.

**Quick recipe contribution:** Open a GitHub issue with your recipe description (grind size, ratio, steps, timings). We’ll review and add it.

**Development:** Fork the repo, create a feature branch, and submit a Pull Request.

Please see existing issues for ideas, feature requests, or bug reports.

---

## Translation

If you want to contribute to app interface translation, there are 2 ways to do it:

1. Improve existing translation: find corresponding language file in [l10n](lib/l10n) folder, edit file and submit Pull Request, ideally with explanation of change.
2. Translate app to new language: fork repo, translate [base English .arb file](lib/l10n/app_en.arb), following the formatting, add new .arb file to l10n folder, submit pull request.

**Important**: Please don't edit .dart files in l10n folder, they're generated automatically during app build. Also, if you use LLMs for translation, please make sure to check correctness and consistency of translation.

---

## Support Development

If you find the app useful, you can support ongoing development with an optional donation:  
👉 [Buy Me a Coffee](https://buymeacoffee.com/timercoffee)

Thank you! Enjoy your coffee ☕

---

## License

Timer.Coffee is released under the [GNU General Public License v3.0](LICENSE).

![big-size-light](https://www.timer.coffee/_next/image/?url=%2Fassets%2Fimages%2Fdevice-specific%2Fbig-size-light.webp&w=1200&q=75)

timer-coffee

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README