MMM-MealieMenu

MMM-MealieMenu is a module for MagicMirror² that displays your Mealie meal plan for the week.

Description

This module shows your meal plan from Mealie.

Mealie is an intuitive and easy to use recipe management app. It's designed to make your life easier by being the best recipes management experience on the web and providing you with an easy to use interface to manage your growing collection of recipes.

Mealie is self-hostable, meaning you can run it on your own server without any reliance on cloud-services.

How it Works

After you installed MMM-MealieMenu you just configure it to your needs and that's it. You will need to provide the Mealie host and credentials as an apiKey or username & password.

For more information see the Configuration section.

Screenshots

Installation

Just clone MMM-MealieMenu into the modules folder of your MagicMirror² installation:

cd ~/MagicMirror/modules
git clone https://github.com/zanix/MMM-MealieMenu

Update

Go to the MMM-MealieMenu folder inside MagicMirror² modules folder and pull the latest version from GitHub:

cd ~/MagicMirror/modules/MMM-MealieMenu
git pull

Restart MagicMirror² after updating.

Configuration

The module is quite configurable. The only required options are host, apiKey (or username/password) - all other options are optional.

These are the possible options:

Option	Description
host	The URL to your Mealie instance. REQUIRED Type: string Example: "https://mealie.yourdomain.com" Default value: none
apiKey	An API key generated from a user profile in Mealie. REQUIRED When not using username and password Type: string Example: "eyhJbcG..." Default value: none Note: You can generate a key by going to your user profile in Mealie then to API Tokens link (or using this path /user/profile/api-tokens).
username	The username/email for your Mealie account. REQUIRED When not using apiKey Type: string Example: "yourmeailieemail@email.com" Default value: none
password	The password for your for Mealie account. REQUIRED When not using apiKey Type: string Example: "Secret!" Default value: none
householdId	The Household ID (as a UUID) to use when fetching the meal plan. Type: string Example: "41300275-fb6b-41eb-8b2b-e56f83e7b349" Default value: none ("Family" household) Note 1: You can get the UUID of a household from Settings > Households. Note 2: The default "Family" household is used when this is blank. Note 3: For Mealie v1, Households do not exist, use Groups.
groupId	The Group ID (as a UUID) to use when fetching the meal plan. Type: string Example: "c0aa0c1c-bdbb-4948-823b-2a725fb05ce1" Default value: none ("Home" group) Note 1: You can get the UUID of a group from Settings > Groups. Note 2: The default "Home" group is used when this is blank.
currentWeek	Only show meals for the current week. Set to true to display meals up-to the end of the week. The beginning of the week is set using weekStartsOnMonday. The number of meals displayed is limited by dayLimit, entryLimit, priorDayLimit, and priorEntryLimit. Type: boolean Default value: true Possible values: true and false
weekStartsOnMonday	Show Monday as the first day of the week. Set to true to show Monday as the first day of the week. Type: boolean Default value: false Possible values: true and false Note: Only valid when currentWeek is set to true.
dayLimit	How many days will be displayed after today. Type: integer Example: 5 Default value: 7 Unit: days Note: If 0, only today will be shown. Note 2: If currentWeek is true, the max number of days is until the end of the week.
priorDayLimit	How many previous days will be displayed. Type: integer Example: 5 Default value: 7 Unit: days Note 1: If 0, no previous days will be shown. Note 2: If currentWeek is true, the max number of days is until the beginning of the week.
entryLimit	How many entries from future days should be shown in total. Type: integer Example: 25 Default value: 50 Unit: meals Note: dayLimit takes precedence. For example, with 3 entries per day, entryLimit set to 5 and dayLimit set to 1, you will only see 3 future entries.
priorEntryLimit	How many entries from previous days should be shown in total. Type: integer Example: 25 Default value: 50 Unit: meals Note: priorDayLimit takes precedence. For example, with 3 entries per day, priorEntryLimit set to 5 and priorDayLimit set to 1, you will only see 3 prior entries.
fadePriorEntries	Fade previous days in the current week. Type: boolean Default value: true Possible values: true and false
showPictures	Show pictures corresponding to that days meal. Type: boolean Default value: true Possible values: true and false
roundPictureCorners	Round the meal picture corners. Type: boolean Default value: false Possible values: true and false
defaultPicture	Picture to display for missing recipe images or meal notes. Type: string Example: "https://img.icons8.com/nolan/64/meal.png" Default value: "mealie.png" Note: If the image does not have http or / in the name, the MMM-MealieMenu module path will be prepended to the name.
showDescription	Show the recipe description or meal note. Type: boolean Default value: false Possible values: true and false
dateFormat	Display format for the date; uses moment.js format string Type: string Example: "ddd DD" Default value: "dddd"
dateMealSeperator	Set the separator between the date and meal type. Type: string Example: " | " Default value: " - " Note: Above each menu item, the date and meal type are displayed. For example, by default you'll see "Tuesday - Dinner". This setting controls the characters separating dateFormat and the meal display.
mealSortOrder	An array determining the order of the meal type headers. Type: array Example: [ "lunch", "dinner" ] Default value: [ "breakfast", "lunch", "dinner", "side" ] Possible values: [ "breakfast", "lunch", "dinner", "side" ] Note 1: You can remove a meal type here by removing the value. Note 2: The values MUST match the possible values above. You can change what is displayed using the mealTypeName options below.
mealTypeName	An object defining strings which are to be replaced in the displayed directions. Type: object Example: { "side": "Meal Prep", "dinner": "Supper" } Default value: {} Note: The strings which appear as the keys of the object will be replaced by their values. Given a meal type "side" and the above mentioned example setting the displayed meal type will be "Meal Prep". Note 2: If you want to replace special symbols like (, ) or - you must escape these characters by placing two back-slashes \ in front of the character.
updateInterval	The time in seconds when the meal plan should be updated. Type: integer Example: 300 (The meal plan will be refreshed every 5 minutes.) Default value: 3600 (1 hour) Unit: seconds
animationSpeed	Speed of the update animation. Type: integer Possible values: 0 - 5000 Default value: 500 Unit: milliseconds
displayLastUpdate	Display the last update time at the end of the meal plan list. Type: boolean Default value: true Possible values: true and false
displayLastUpdateFormat	Format to use for the time display if displayLastUpdate:true; uses moment.js format string Type: string Example: 'HH:mm:ss' Default value: 'MMM D - h:mm:ss a'

Here is an example of an entry in config.js. Take note of mealTypeName and mealSortOrder. Here, we use the side meal type as a reminder of things we need to do to prepare for future meals, e.g., thaw meat. mealTypeName changes what appears, and mealSortOrder moves the side entries to the top of the list for each day.

{
    module: "MMM-MealieMenu",
    header: "Dinner Menu",
    position: "top_left",
    config: {
        apiKey: "eyhJbcG...",                  // Not needed when using username/password
        username: "yourmealieemail@email.com", // Not needed when using apiKey
        password: "Secret!",                   // Not needed when using apiKey
        weekStartsOnMonday: true,
        roundPictureCorners: true,
        mealSortOrder: ["side", "breakfast", "lunch", "dinner"],
        mealTypeName: {
            side: "Meal Prep"
        }
    }
},

Multiple Instances

It is possible to use multiple instances of this module just by adding another entry of the MMM-MealieMenu module to the config.js of your mirror.

Special Thanks

• Michael Teeuw for creating the project MagicMirror². You can sponsor the MagicMirror² project on their donate page.
• Kael Spencer for creating the MMM-PaprikaMenu module, on which this one is originally based.
• Brian O'Connor for contributing to this project.

Contributing

If you find any problems, bugs or have questions, please open a GitHub issue in this repository.

Pull requests are of course very welcome. Please see Contributing and the Pull Request Template for details.