https://github.com/sepandhaghighi/mycoffee
☕ Brew Perfect Coffee Right from Your Terminal
https://github.com/sepandhaghighi/mycoffee
brew brewing cafe calculator calculator-application chemex coffee espresso fun geek python python3 ratio terminal terminal-based v60
Last synced: about 2 months ago
JSON representation
☕ Brew Perfect Coffee Right from Your Terminal
- Host: GitHub
- URL: https://github.com/sepandhaghighi/mycoffee
- Owner: sepandhaghighi
- License: mit
- Created: 2024-06-28T16:20:06.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-10-18T15:39:42.000Z (7 months ago)
- Last Synced: 2024-10-25T03:48:03.514Z (7 months ago)
- Topics: brew, brewing, cafe, calculator, calculator-application, chemex, coffee, espresso, fun, geek, python, python3, ratio, terminal, terminal-based, v60
- Language: Python
- Homepage:
- Size: 98.6 KB
- Stars: 45
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Authors: AUTHORS.md
Awesome Lists containing this project
README
MyCoffee: Brew Perfect Coffee Right from Your Terminal
## Overview
MyCoffee is a command-line tool for coffee enthusiasts who love brewing with precision. It helps you calculate the perfect coffee-to-water ratio for various brewing methods, ensuring you brew your ideal cup every time-right from your terminal.
PyPI Counter
Github Stars
Branch
main
dev
CI
Code Quality
## Installation
### Source Code
- Download [Version 1.7](https://github.com/sepandhaghighi/mycoffee/archive/v1.7.zip) or [Latest Source](https://github.com/sepandhaghighi/mycoffee/archive/dev.zip)
- `pip install .`
### PyPI
- Check [Python Packaging User Guide](https://packaging.python.org/installing/)
- `pip install mycoffee==1.7`
## Usage
ℹ️ You can use `mycoffee` or `python -m mycoffee` to run this program
### Version
```console
> mycoffee --version
1.7
```
### Info
```console
> mycoffee --info
__ __ ____ __ __
| \/ | _ _ / ___| ___ / _| / _| ___ ___
| |\/| || | | || | / _ \ | |_ | |_ / _ \ / _ \
| | | || |_| || |___ | (_) || _|| _|| __/| __/
|_| |_| \__, | \____| \___/ |_| |_| \___| \___|
|___/
__ __ _ _____
\ \ / / _ / | |___ |
\ \ / / (_)| | / /
\ V / _ | | _ / /
\_/ (_)|_|(_) /_/
MyCoffee is a command-line tool for coffee enthusiasts who love brewing with precision.
It helps you calculate the perfect coffee-to-water ratio for various brewing methods,
ensuring you brew your ideal cup every time-right from your terminal.
Repo : https://github.com/sepandhaghighi/mycoffee
```
### Method
```console
> mycoffee --method=v60
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Method: `v60`
Cups: 1
Coffee: 15 g
Water: 250 g
Ratio: 3/50 (0.06)
Strength: Medium
Grind: 550 um (Medium-Fine)
Temperature: 91 C
Message: V60 method
```
* [Methods List](https://github.com/sepandhaghighi/mycoffee/blob/main/METHODS.md)
* `mycoffee --methods-list`
### Customize
ℹ️ You can run `mycoffee --coffee-units-list` to view the supported coffee units
ℹ️ You can run `mycoffee --water-units-list` to view the supported water units
```console
> mycoffee --method=chemex --water=20 --cups=3 --coffee-ratio=2 --water-ratio=37 --coffee-unit="t oz" --water-unit="fl oz" --grind=750 --temperature=88
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Method: `chemex`
Cups: 3
Coffee: 3.084 t oz
Water: 20 fl oz
Ratio: 2/37
Grind: 750 um (Medium)
Temperature: 88 C
Message: Chemex method
```
### Save
ℹ️ File format valid choices: [`text`, `json`]
ℹ️ The default file format is `text`
```console
> mycoffee --method=chemex --water=20 --cups=3 --coffee-ratio=2 --water-ratio=37 --save-path="profile1.txt" --save-format="text"
```
## Parameters
Parameter
Description
Type
Default
--method
Specifies the coffee brewing method
String
custom
--water
Sets the amount of water in each cup
Positive float
240
--cups
Indicates the number of cups
Positive integer
1
--grind
Grind size (um)
Positive integer
700
--temperature
Brewing temperature
Float
90
--coffee-ratio
Coefficient for the coffee component in the ratio
Positive float
1
--water-ratio
Coefficient for the water component in the ratio
Positive float
17
--message
Extra information about the brewing method
String
Custom brewing method
--digits
Number of digits up to which the result is rounded
Integer
3
--coffee-unit
Coffee unit
String
g
--water-unit
Water unit
String
g
--temperature-unit
Temperature unit
String
C
## Issues & Bug Reports
Just fill an issue and describe it. We'll check it ASAP!
- Please complete the issue template
## References
1- Coffee to water ratio calculator
2- V60 Brew Guide
3- How to Brew Coffee with a Chemex
4- Using French press for perfect coffee
5- How to Brew the Perfect Cup of Siphon Coffee
6- Using Espresso Brew Ratios
7- My Best Coffee Recipes of 2022
8- Auto Drip Brewing Guide
9- Guide To Cold Brew
10- Cold Brew Concentrate Recipe
11- How to Make Coffee in a Moka Pot
12- How to Make Turkish Coffee at Home
13- How to Cup Coffee
14- Tetsu Kasuya AeroPress Recipe
15- All about the intervals
16- Clever Dripper; Square Mile Coffee
17- AeroPress Product User Manuals
18- RapidTables - Weight Converter
19- Whole bean to ground coffee calculator
20- Weight to Volume Converter for Recipes
21- How Much Coffee per Cup?
22- Weight Calculator
23- Volume Conversion Calculator - Inch Calculator
24- Metric Conversion Charts and Calculators
25- Coffee grind size chart
26- The best temperature to brew coffee
27- How to Brew Coffee with a Syphon
28- Guide To Home Coffee Makers
29- Can you brew coffee with warm water?
30- How to Brew Coffee Using a Cezve
31- Coffee cupping
## Show Your Support
Star This Repo
Give a ⭐️ if this project helped you!
Donate to Our Project
Bitcoin
1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy
Ethereum
0xcD4Db18B6664A9662123D4307B074aE968535388
Litecoin
Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ
Doge
DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh
Tron
TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7
Ripple
rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq
Binance Coin
bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef
Tether
0xcD4Db18B6664A9662123D4307B074aE968535388
Dash
Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s
Stellar
GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL
Zilliqa
zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5
Coffeete
