MMM-LittleBockFermentationLog est un module pour MagicMirror² qui permet d'afficher le suivi de la fermentation de brassins de bière en utilisant l'API de Little Bock.
Clonez ce dépôt dans votre dossier de modules MagicMirror :
cd ~/MagicMirror/modules
git clone https://github.com/SBrendan/MMM-LittleBockFermentationLogVous pouvez ajouter le module dans le fichier config.js de MagicMirror avec les options suivantes :
| Option | Valeur par défaut | Description |
|---|---|---|
apiToken |
"" |
Obligatoire. Votre token d'API Little Bock. Type: string |
brewSessionID |
0 |
Obligatoire. L'ID de la session de brassage à afficher. Type: string |
updateInterval |
3600000 (1 heure) |
Intervalle de mise à jour des données en millisecondes. Type: integer |
animationSpeed |
1000 |
Vitesse de l'animation lors de la mise à jour des informations. Type: integer |
layout |
"horizontal" |
Choix de l'agencement des éléments (graphique et cartes). Type: string Valeurs possibles: "cardsOnly", "horizontal" |
{
module: "MMM-LittleBockFermentationLog",
position: "top_right",
config: {
apiToken: "VOTRE_TOKEN",
brewSessionID: "57094",
updateInterval: 60 * 60 * 1000, // Mise à jour toutes les heures
animationSpeed: 1000, // 1 seconde
layout: "horizontal", // Choix du layout : cardsOnly, horizontal
}
},Le module utilise un système de cache pour éviter de dépasser la limite de 150 requêtes par heure imposée par Little Bock. À l'initialisation, toutes les pages de données de fermentation sont chargées et stockées en cache. Par la suite, le module ne vérifie que les nouvelles pages disponibles toutes les heures, ce qui permet de limiter les appels à l'API tout en s'assurant que les données restent à jour.
- Affichage du suivi de la fermentation : Le module affiche la température, la densité, le taux d'alcool estimé et l'atténuation dans une grille de cartes et/ou un graphique.
- Layouts personnalisables : Choisissez entre l'affichage de seulement les cartes, un layout vertical ou horizontal pour adapter le module à vos préférences.
- Cache de données : Le module utilise un cache pour réduire les appels à l'API, récupérant toutes les pages au démarrage, et vérifiant les nouvelles pages disponibles toutes les heures.
- Merci à l'équipe de Little Bock pour leur API et leur soutien à la communauté des brasseurs.
- Un grand merci à Michael Teeuw pour la création de MagicMirror², le framework qui a rendu ce module possible.
MMM-LittleBockFermentationLog is a module for MagicMirror² that displays beer brewing fermentation tracking using the Little Bock API.
Clone this repository into your MagicMirror modules folder:
cd ~/MagicMirror/modules
git clone https://github.com/SBrendan/MMM-LittleBockFermentationLogYou can add the module in the MagicMirror config.js file with the following options:
| Option | Default value | Description |
|---|---|---|
apiToken |
"" |
Required. Your Little Bock API token. Type: string |
brewSessionID |
0 |
Required. The ID of the brewing session to display. Type: string |
updateInterval |
3600000 (1 hour) |
Interval for data updates in milliseconds. Type: integer |
animationSpeed |
1000 |
Speed of the animation when updating the information. Type: integer |
layout |
"horizontal" |
Layout choice for the elements (graph and cards). Type: string Possible values: "cardsOnly", "horizontal" |
{
module: "MMM-LittleBockFermentationLog",
position: "top_right",
config: {
apiToken: "YOUR_TOKEN",
brewSessionID: "57094",
updateInterval: 60 * 60 * 1000, // Updates every hour
animationSpeed: 1000, // 1 second
layout: "horizontal", // Layout options: cardsOnly, horizontal
}
},The module uses a cache system to avoid exceeding the 150 requests per hour limit imposed by Little Bock. On initialization, all fermentation data pages are loaded and stored in the cache. The module then checks only for new available pages every hour, reducing API calls while ensuring the data stays up to date.
- Fermentation tracking display: The module displays temperature, gravity, estimated alcohol content, and attenuation in a card grid and/or graph.
- Customizable layouts: Choose between displaying only cards or a vertical or horizontal layout to fit your preferences.
- Data caching: The module uses caching to reduce API calls, fetching all pages on startup and checking for new pages every hour.
- Thanks to the team at Little Bock for their API and support for the brewing community.
- A big thank you to Michael Teeuw for creating MagicMirror², the framework that made this module possible.



