Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/graphefruit/beanconqueror

An open source project for coffee enthusiasts.
https://github.com/graphefruit/beanconqueror

android app coffee cordova ionic ios specialy-coffee typescript

Last synced: about 15 hours ago
JSON representation

An open source project for coffee enthusiasts.

Awesome Lists containing this project

README 

        
[![license](https://img.shields.io/badge/license-GPL%203.0-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html) [![Github All Releases](https://img.shields.io/github/downloads/graphefruit/beanconqueror/total.svg)](https://github.com/graphefruit/beanconqueror/releases) [![GitHub Release Date](https://img.shields.io/github/release-date/graphefruit/beanconqueror.svg)](https://github.com/graphefruit/beanconqueror/releases)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=graphefruit_Beanconqueror&metric=alert_status)](https://sonarcloud.io/dashboard?id=graphefruit_Beanconqueror)



# Beanconqueror



Beanconqueror - The Ultimate Coffee Companion



You’re a coffee afficiando, and so am I!

Beanconqueror is the product of our shared love of the drink in our cups and in our hearts.

Whether you're just starting out, or are an experienced barista, Beanconqueror will help you get the most out of your coffee.



Optimize your brews:

Beanconqueror offers a wide range of preparation methods, including V60, Aeropress, Espresso, Orea v3, Mokkamaster and more.

Each comes setup ready to go, or you can customize your preparation methods with just the parameters you want to use.

This way, you can get your perfect brew every time.



Keep track of your beans:

Beanconqueror makes it easy to keep track of all your beans.

You can easily scan or import detailed information of roasted coffee from your favourite roasters, or even from your own roasting setup.

It’ll even keep track of your running total of beans so you know when you’re running low.



Track your roasts:

Add all the details for your green beans, roast them in batches tracking the variables you need to to maintain consistency, and automatically transfer your finished roasts to use for brewing.



Dedicated water section:

Beanconqueror also has a dedicated water section where you can add your custom waters to be used in the brew section.

Save all the key information for your water recipes, such as general hardness, sodium, calcium, magnesium, and more.



Flexibility and Convenience:

Beanconqueror is available for both iOS and Android, so you can take it with you wherever you go.

It also supports several languages, including English, German, Spanish, Chinese, and Turkish, and more will be added in the future. Beanconqueror is also Open Source and free to use.



Flow & Pressure Profiling:

Beanconqueror is compatible with a range of bluetooth scales and pressure profile devices, including Decent Scale, Acaia Scales, Felicita Scales, Hiroia Jimmy, Eureka Precisa, Skale2, Smart Espresso Profiler, and Pressensor.

It can even produce graphs to track your brew live and help you repeat your favourite brews more easily.



Track your caffeine consume into Apple Health and have a look there.



Whether you're looking to track your coffee journey, optimise your brews, or simply keep track of your coffee beans, Beanconqueror has everything you need to perfect your brew from green to cup.



##### Follow me



| [Website](https://beanconqueror.com/) | [Instagram](https://www.instagram.com/beanconqueror/) | [Facebook](https://www.facebook.com/Beanconqueror/) |



## Sneak preview



![Beanconqueror gif](demo/Beanconqueror.gif)



## Articles



- German: [iphone-ticker](https://www.iphone-ticker.de/beanconqueror-app-geheimtipp-fuer-espresso-verrueckte-168517/) [wuv](https://www.wuv.de/tech/techtaeglich_super_mario_rast_durch_berlin)



## Threads



- German: [Kaffee-Netz](https://www.kaffee-netz.de/threads/beanconqueror-app.111249)

- English: [Home-Barista](https://www.home-barista.com/knockbox/beanconqueror-app-t68236.html)

- Dutch [tweakers](https://gathering.tweakers.net/forum/list_messages/1635607/44) [koffiepraat](https://www.koffiepraat.nl/forum/viewtopic.php?t=9842)

- Greek: [greekespresso](https://www.greekespresso.gr/forum/viewtopic.php?f=4&t=7251&p=97854&hilit=beanconqueror#p97854)

- Turkish: [kahvekulubu](https://www.kahvekulubu.net/sosyal/threads/kahve-loglama-kayit-oneri-yontem-metodoloji.3483/)



## Rankings



On January 2021, the app got a bit hyped, through german featuring articles, the top rankings because of this you find below.



### Android



Top charts: Eat & Drink - Rank 5

Eat & Drink Ranking - Rank 70



### iOS



Eat & Drink Raking - Rank 36



## Features



Different features are supported by this app, a brief overview you'll find here.



- Add your own beans / grinders / preparation methods

- Record different brew-parameters like:

  - grind size

  - grind amount

  - brew time

  - first coffee drip

  - images

  - etc.

- Manage your own workflow, first grind amount, then grind size? No problem

- Archive old beans / grinders / preparation methods

- Rate your brews

- Cup your brews by SCA

- Own roasting section

- Own water section

- Cup your brews by aromatics or flavors

- Connect smart scales (Decent Scale, Acaia Lunar, Hiroia Jimmy, Felicita)



## Special thanks



- Nicola for giving the app a whole new design.

- Frank for translating the app into spanish.

- [Joan](https://github.com/Jglez3) - for Spanish translation

- [Halil Portakal](https://www.kahvekulubu.net/sosyal/members/portakalhalil.3158/) for Turkish translation

- [Jiageng Ding](https://github.com/JiagengDing) for Chinese translation

- [Mimoja](https://github.com/Mimoja/) For supporting on Decent Scale integration & Eureka Scale support

- [Silas](https://github.com/silasg) - For supporting Hiroia Jimmy Scale

- [Mehalter](https://github.com/mehalter) - For supporting Acaia Scales

- [Mike](https://github.com/mike1808) - For supporting Acaia Scales & DIY Pressure Sensor

- [Myles](https://github.com/mylesagray) - For supporting Thermo Bluetooth Devices

- [Herman](https://github.com/hermanmak) - For supporting Felicita Arc

- [Yannick](https://github.com/randomcoffeesnob) - For supporting DiFluid Microbalance & Smart Chef Scale, BlackCoffee.IO. Also for adding Lokalise



## Getting the App



The App is a cross platform application, running on the ionic framework.



### Android



Download the latest version [here](https://play.google.com/store/apps/details?id=com.beanconqueror.app).



If you don't want to download the app by playstore, just have a look on the [release page](https://github.com/graphefruit/Beanconqueror/releases).



### iOS



Download the latest version [here](https://apps.apple.com/de/app/beanconqueror/id1445297158).



## :sparkling_heart: Support the project



You want to support me, to access more people to explore the world of good coffee



[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/paypalme/LarsSaalbach) - Support me once



[![Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=white)](https://www.buymeacoffee.com/beanconqueror) - Support me once or often



Or sponsor me via Github



Thanks! :heart:



## Contribution



Before continuing it is important to note that Beanconqueror is open source available.



I welcome pull requests, but you will be required to sign the Beanconqueror CLA before any contributions can be merged.



## Statistics



![Graphefruit github stats](https://github-readme-stats.vercel.app/api?username=graphefruit&theme=dark&repo=Beanconqueror)



![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=graphefruit&theme=dark)



## Third Party Apps



Beanconqueror Universe is growing outside :)

Therefore some users did third party apps, where I don't have any stakes in it.

Important: Beanconqueror doesn't take any warranty here.



Add beans to share directly from a webform:

https://beanstats.vercel.app/beanconqueror/share/create

(Uses the minify-logic of the add.beanl.ink aswell)



Minify your shared bean-link:

https://add.beanl.ink/



Get some more statistics:

https://beanstats.vercel.app/



## Questions



### Why is external storage not supported?



Sadly there are some issues to read/use files from external storage

https://github.com/apache/cordova-plugin-file/issues/350



### Why is image-export functionality not support on iOS?



iOS filesystem is different then on Android, because of this images cannot just be exported.

Thats why just Android is support by now.



### iOS - iCloud-Backup



You can backup Beanconqueror via iCloud, with this you can transfer all data to another device without any loss.



### Android - Backup & Restore



Have a look here: [FAQ](https://beanconqueror.com/faq)



### Analytics



All tracked data/analytics are visible here: ![Website](https://beanconqueror.com/data-tracking.html)



### Which requirements does the app needs?



The app needs access to your filesystem aswell as the camera



- _Filesytem_: Needed to save images which you took on beans/brews etc or exporting your settings. - Outdated after Android 13 changes.

- _Camera_: Needed to take picures or access the photo library to set images for your beans/brews

- _Internet_: NOT NEEDED! But needed if you want to send me some analytics information to make the app better :)

- _GPS_: NOT NEEDED! Activated through settings, saves the brew location

- _Apple Health_: NOT NEEDED! Activated through settings, saves caffeine amount

- _Wake look_: NOT NEEDED! Activated through settings, won't let your phone get into sleep mode while brewing

- _Bluetooth_: NOT NEEDED! Activated for smart scale use.



# Develop on your own



## Development & Building it yourself



If you're not familiar with Ionic or Cordova [read through the introduction](http://ionicframework.com/docs/intro/installation/).

To get started with anything you need [Node.js](https://nodejs.org/en/download/) installed



## Want to check the code quality?



https://sonarcloud.io/dashboard?id=graphefruit_Beanconqueror



## Get Started



```

npm install -g [email protected]

npm install -g @ionic/cli

npm run prepare

```



## Build iOS



Always use the .workspace-File to open in Xcode



```

ionic cordova build ios

```



## Build Android



```

ionic cordova build android

```



### Check outdated dependencies



```

npm outdated

```



### Check outdated plugins



```

cordova-check-plugins

```



### NPM-Version



npm -v -> 9.6.4 - works



### NodeJS-Version



node -v -> v18.15.0 -> works



### iOS-Version:



`ionic cordova platform add [email protected]`



### Android-Version:



`ionic cordova platform add [email protected]`

`jdk 17 needed`



You need to remove WRITE_EXTERNAL_STORAGE on the x-socialshare plugin.xml



### Github Page Hosting



https://stackoverflow.com/questions/60357663/do-apple-app-site-association-files-work-with-github-pages-i-e-site-github-io



### Upgrade Ionic if needed:



`npm install @ionic/[email protected]`

-> Or the actual active version



### Installing AAB on your android (mac)



https://stackoverflow.com/questions/50419286/install-android-app-bundle-on-device

brew install bundletool

bundletool build-apks --bundle=./app.aab --output=./app.apks

bundletool install-apks --apks=app.apks



Compile deson't work on android?

Try:

`cordova build android -- --jvmargs='-Xmx2048M -Dkotlin.daemon.jvm.options\="-Xmx2048M" --add-exports=java.base/sun.nio.ch=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.lang.reflect=ALL-UNNAMED --add-opens=java.base/java.io=ALL-UNNAMED --add-exports=jdk.unsupported/sun.misc=ALL-UNNAMED'`