Warning

This guide is for Paprika 4, which is currently in beta. Switch to the Paprika 3 guide.

The Settings window on the Mac, on the General tab: the tabs across the top, then the Browser, Appearance, Recipes and Keyboard groups.
  1. Settings tabs List of Settings
  2. Account tab Account
  3. Browser settings List of Settings
  4. Appearance settings List of Settings
Settings in Paprika for Mac.

The settings window allows you to configure Paprika's default behavior.

It also provides access to your Paprika account and syncing. Paprika's import, export, and Find Duplicates tools live in the File menu — see Import Recipes, Export Recipes, and Find Duplicates below.

Accessing the Settings Panel

Paprika's settings can be accessed by navigating to Paprika -> Settings… in the menu bar (or pressing Command-,). You can also click the button at the top of the sidebar. The settings window is divided into five tabs: General, Email, Groceries, Meals, and Account.


List of Settings

General - Browser
Home Page Can be used to set the default home page on the browser screen.
Open Links In Choose whether links open in Paprika's built-in browser or in your default web browser.
Plugins Enabled Whether or not web browser plugins are enabled.
Cache Button to clear the web browser cache.
General - Appearance
Startup Screen Choose which section Paprika opens to when it launches.
Recipe Font Size Adjusts the font size of the ingredients and directions on the recipe screen.
Show Image Placeholder Shows a placeholder for recipes that do not have a photo. Otherwise the recipe name will be left aligned with no thumbnail.
Recipes List Rows Choose which details (such as name, rating, and categories) are displayed for each recipe in the recipes list.
General - Recipes
Auto-Suggest Categories If turned on, Paprika suggests categories automatically when you add a recipe from the browser, the clipboard, or a scan. See Suggesting Categories. Requires Paprika 4 Premium.
Suggest New Categories If turned on, category suggestions can include categories you don't have yet. Turn it off to use only your existing categories. Requires Paprika 4 Premium.
General - Keyboard
Show Text Formatting Buttons Whether the formatting toolbar is displayed while editing recipe text. Turn this off if you prefer to type the Markdown formatting yourself.
Email
Default Recipient Sets a default recipient in the To: field for any email messages. Note You can enter multiple recipients by separating them with commas.
Send Email With Which service to use to email recipes, grocery lists, etc.: macOS Mail app, SMTP Server, or Gmail. By default Paprika uses the macOS Mail app, which requires an email account configured in Mail. Alternatively, you can configure an SMTP server manually, or choose Gmail and click Set Up Account to sign in with your Google account.
Groceries
Consolidate Ingredients If turned on, the grocery list will attempt to consolidate similar items with one another. For example, if one recipe calls for 2 eggs, and another recipe calls for 3 eggs, the consolidated listing will display 5 eggs total. If turned off, the grocery list will display each item individually.
Show Recipe Names If turned on, the recipe name will display in the grocery list underneath the ingredient and quantity.
Aisles Click Customize to change and reorder the grocery list aisles. You can add new aisles, delete aisles, and rename them.
Meals
Week Starts On First day of the week. Used when displaying a week of meals or selecting a date for a meal.
Meal Types Click Customize... to add, remove, change and reorder the existing meal types. You can also associate a color and a time with each meal type.
Calendar Export Options Allows you to configure the name of the exported Calendar and the time zone used for exported meals.
Calendar Feed Creates a link that calendar apps can subscribe to, so your meal plan appears in them and stays up to date. See Calendar Feed. Requires Paprika 4 Premium.

The Account tab is described under Account below.


Account

The Account tab of the settings window (called Cloud Sync in earlier versions) is where you create or log into your Paprika account, manage your account details, and control syncing.

Paprika Cloud Sync

Paprika Cloud Sync is an automated backup and syncing service for your recipe collection. It will automatically upload your recipes, cookbooks, categories, grocery lists, pantry, meals, and other data to our cloud servers, ensuring your data is safely backed up.

If you have Paprika installed on multiple devices, you can also use Paprika Cloud Sync to keep your data synced across all of those devices.

Note

Paprika Cloud Sync does not use iCloud. Instead, you will need to create a separate Paprika account as described below. Syncing will not be enabled until you set up a Paprika account.

Note

Paprika Cloud Sync isn't available in the free version. It's included for Paprika 3 owners and with Paprika 4 Premium.


Accessing your Account

Your account can be accessed via the Account tab of the Settings window. Your account email and last-synced time are also displayed at the bottom of the sidebar.


Creating an Account

You'll create one Paprika account for all devices sharing the same recipe collection. You can do this through the settings pane of any version of Paprika, and then log in to that same account on all other versions of Paprika.

To create an account, open the Settings window, and then select the Account tab. Then select Sign Up.

Enter in your name, and the email address and password you would like to use for this account.

Note

If you already have an account, please login to that account instead of creating a new one. Recipes synced with an existing account will not be available under a new account.


Logging In

If you already have an account, you can log back into it using the Log In button on the account screen.


Managing your Account

After logging in, you can manage your account and sync status from the Account settings pane.

Account Status
Name The name associated with the account.
Email The email address associated with the account.
Sync Status
Last Synced The date of the last successful sync attempt.
Status The result of the last sync attempt. This will say Success if you were able to successfully sync. If your device was not able to connect to the sync server, the associated message will be displayed here.
Sync Settings
Update

You can choose how often you would like to sync using the Update dropdown.

  • Automatically - The sync runs every 5 minutes on any available network, and it also runs whenever you start Paprika. It also runs whenever you make a change (like adding a recipe) and listens for changes occurring on other devices.
  • Manually - The sync only runs when you press a sync button.
Actions
Log Out Pressing this lets you log out of your account and cancels the sync, if running.
Manage Account A dropdown menu containing Change Name, Change Email, Change Password, and Delete Account. Note Your name is shown to recipients when you send in-app messages.
Sync Now Pressing this will initiate a new sync immediately.

Quick Sync

If you are logged in, your account email and last-synced time are displayed at the bottom of the sidebar. Click the sync icon beside them to start a new sync. You can also choose Sync -> Sync Now in the menu bar, or press Command-Y.

If you aren't logged in, the bottom of the sidebar shows Set Up Sync instead. Click it to open the Account tab of the settings window.


Deleting your Account

If you would like to permanently delete your Paprika account and all of the data associated with it, choose Delete Account from the Manage Account dropdown in the Account tab. You will be asked to confirm before the deletion is processed.

Note

Account deletion is permanent. Your synced recipes, photos, and other data will be removed from our servers and cannot be recovered. If you would like to keep a copy of your recipes, export them first.


Import Recipes

Paprika can import recipe databases from several other applications. To perform an import:

  1. Go to File -> Import… in the menu bar.
  2. Select the file to be imported. Paprika chooses the Format at the bottom of the window from the file's extension. If more than one format uses that extension, such as .zip, choose the format yourself.
  3. Choose the Cookbook for the imported recipes. It starts with the cookbook you're viewing. For a Paprika file, Import cookbooks from file is turned on at first, and puts each recipe into the cookbook it was exported from instead.
  4. Click Open, then click Import to confirm.

When the import finishes, Paprika reports how many recipes were imported and how many existing recipes were updated.

Note

When importing a Paprika export file, recipes that already exist in your collection are updated rather than duplicated — and if a matching recipe is in your trash, it will be restored.

The currently supported file types are:

Supported File Types
.paprikarecipe & .paprikarecipes Paprika's emailed recipe format and its export format.
.ysr YummySoup! export format.
.mgourmet, .mgourmet3, & .mgourmet4 MacGourmet export format.
.mx2, .mxp & .mz2 MasterCook export formats.
.mmf MealMaster export format.
.fdx & .fdxz Living Cookbook export formats.
.yml & .yaml A plain YAML file. See below for more details on this format.
.dvo Cook'n export format.
.txt The Recipe Manager export format.
.mcb My CookBook export format.
.db & .zip Pepperplate database file. Click here for instructions on how to get your database file from Pepperplate.
.hcb Handy CookBook export format.
.sqlite My Recipe Book database file.
.rbox The Recipe Box export file.
.zip Copy Me That export file.
.xml Yum export file.

YAML Format

YAML is a simple, plain text file with sections delimited by key-value pairs. To indicate a block of text, use an initial pipe character, as shown in directions and ingredients. Consistent indenting should be used, but the order of the fields does not matter, and most are optional with the exception of the name, ingredients and directions. It is recommended that you use an online YAML validator such as this one to validate your file if you're experiencing difficulties importing.

Note

The YAML format is quite strict with regards to whitespace and indentation. Please also make sure your file is saved with a UTF-8 encoding.

YAML recipe example:

name: My Tasty Recipe
servings: 4-6 servings
source: Food Network
source_url: http://www.google.com
prep_time: 10 min
cook_time: 30 min
on_favorites: yes
categories: [Dinner, Holiday]
nutritional_info: 500 calories
difficulty: Easy
rating: 5
notes: |
  This is delicious!!!
photo: (base-64 encoded image)
ingredients: |
  1/2 lb meat
  1/2 lb vegetables
  salt
  pepper
  2 tbsp olive oil
  4 cups flour
directions: |
  Mix things together.
  Eat.
  Tasty.
  Yum yum yum.

YAML multiple recipes example:

- name: My Tasty Recipe
  servings: 4-6 servings
  source: Food Network
  source_url: http://www.google.com
  prep_time: 10 min
  cook_time: 30 min
  nutritional_info: 500 calories
  on_favorites: yes
  categories: [Dinner, Holiday]
  difficulty: Easy
  rating: 5
  notes: |
    This is delicious!!!
  ingredients: |
    1/2 lb meat
    1/2 lb vegetables
    salt
    pepper
    2 tbsp olive oil
    4 cups flour
  directions: |
    Mix things together.
    Eat.
    Tasty.
    Yum yum yum.

- name: My Tasty Recipe 2
  servings: 4-6 servings
  source: Food Network
  source_url: http://www.google.com
  prep_time: 10 min
  cook_time: 30 min
  nutritional_info: 500 calories
  difficulty: Easy
  rating: 5
  photo: | (base-64 encoded image)
  notes: |
    This is delicious!!!
  ingredients: |
    1/2 lb meat
    1/2 lb vegetables
    salt
    pepper
    2 tbsp olive oil
    4 cups flour
  directions: |
    Mix things together.
    Eat.
    Tasty.
    Yum yum yum.

Export Recipes

Paprika currently offers two different export formats:

Export Formats
HTML A standard portable data format that allows you to preserve a copy of your recipe collection. Your recipes will be exported to a directory, with an individual HTML file for each recipe, and an index.html displaying the list of exported recipes. Each recipe file will contain hrecipe metadata in the HTML.
.paprikarecipes Paprika's bulk recipe export format. These files can be easily imported into any copy of Paprika.

How to export your recipes

  1. Go to File -> Export… in the menu bar.
  2. Select the destination folder you would like the export to be saved to.
  3. Choose the cookbook to export under Cookbook, or All Cookbooks. It starts with the cookbook you're viewing. To export a single category instead of All Recipes, click the button beside Categories and choose one.
  4. Choose either HTML or Paprika Recipe Format under Format.
  5. Press Export.

Note

Cookbooks round-trip through export and import: a Paprika Recipe Format file remembers each recipe's cookbook. When you import it with Import cookbooks from file turned on, each recipe goes back into its cookbook, which is created if the account doesn't have it yet.


Find Duplicates

Over the years, it's easy to end up with the same recipe saved more than once. The Find Duplicates tool helps you clean these up. To open it, go to File -> Find Duplicates… in the menu bar.

Under Match Recipes By, select the fields you would like to match: Name, Source, Source URL, Ingredients, and Directions. Only Name is selected at first. Recipes are considered duplicates when all selected fields match; capitals and accents don't matter. Click Search to find duplicate recipes. Paprika searches all of your cookbooks, and leaves out recipes in the Trash.

The matching recipes are displayed in groups, each headed by the recipe's name and its number of copies. In each group, the oldest copy is listed first and marked Keep. Use Select Duplicates to select every copy except the one marked Keep, and review the selection. Then click the delete button, or press Delete, and confirm. The selected recipes are moved to the Trash. If you've selected every copy in a group, the confirmation warns you that no copy of that recipe will remain. Double-click a recipe to open it.


Table of Contents

  1. Introduction
    1. Table of Contents
  2. What's New
    1. Highlights
    2. Other Changes
  3. Beta Testing
    1. Before You Start
    2. What to Test
      1. Adding Recipes
      2. Organizing
      3. Nutrition
      4. Sharing
      5. Pantry
      6. Meals
      7. Integrations
    3. Sending Feedback
  4. Overview
  5. Adding Recipes
    1. Adding a Recipe
    2. Adding a Recipe from the Clipboard
  6. Scanning Recipes
    1. Scanning a Recipe
    2. Editing a Scanned Recipe
    3. Scanning Tips
  7. Browsing Recipes
    1. Browsing by Category
    2. Browsing Subcategories
    3. Searching Recipes
    4. Advanced Search
    5. Saved Searches
    6. Sorting Recipes
  8. Editing Recipes
    1. Editing a Recipe
    2. Deleting Recipes
    3. Recipe Fields
    4. Inserting Recipe Text
    5. Adding Recipe Photos
  9. Viewing Recipes
    1. Recipe Actions
    2. Printing Recipes
    3. Timers
    4. Scaling & Converting Ingredients
    5. Crossing off Ingredients
    6. Marking Directions
    7. Ingredient Substitutions
    8. Pinning Recipes
    9. Recipes Sidebar
    10. Photo Gallery
    11. Gestures & Keyboard Shortcuts
  10. Nutrition
    1. Entering Nutrition Facts
    2. Analyzing Ingredients
    3. Viewing Nutrition
  11. Categories
    1. Assign a Recipe to a Category
    2. Suggesting Categories
    3. Adding a Category
    4. Editing Categories
    5. Built-In Categories
  12. Cookbooks
    1. Switching Cookbooks
    2. Adding a Cookbook
    3. Managing Cookbooks
    4. Moving Recipes between Cookbooks
    5. Sharing a Cookbook
  13. Browser
    1. Using the Browser
    2. Clipping Recipes Online
    3. Clipping Recipes from Social Media
    4. Manually Saving Recipes Using the Clipboard Tools
      1. Tips
  14. Groceries
    1. Adding Ingredients
      1. Adding a Recipe to the Grocery List
      2. Adding a Custom Item to the Grocery List
    2. Editing the Grocery List
      1. Editing Grocery List Items
      2. Removing Items from the Grocery List
    3. Using the Grocery List
      1. Marking Items as Purchased
      2. Filtering Grocery List Items
      3. Searching the Grocery List
      4. Sorting the Grocery List
    4. Managing Multiple Grocery Lists
      1. Viewing your Grocery Lists
      2. Adding a New Grocery List
      3. Renaming a Grocery List
    5. Grocery List Actions
  15. Pantry
    1. Adding Items to the Pantry
    2. Editing Pantry Items
    3. Pantry Locations
    4. Sorting the Pantry
    5. Searching the Pantry
    6. Pantry Actions
  16. Meals
    1. Viewing the Meal Planner
      1. Switching Views
      2. Monthly View
      3. Weekly View
      4. Daily View
    2. Adding a Meal
      1. From the Meal Planner
      2. Drag and Drop from the Recipes Sidebar
      3. From the Recipe Screen
    3. Editing Meals
      1. Changing a Meal's Date or Type
      2. Deleting Meals
      3. Moving or Copying Meals
      4. Scaling Meals
      5. Viewing Recipes from the Meal Planner
    4. Meal Planner Actions
    5. Calendar Feed
  17. Menus
    1. Adding a Menu
    2. Adding Menu Items
    3. Drag and Drop
    4. Adding a Menu to the Meal Planner
    5. Menu Actions
  18. Sharing
    1. Family Sharing
      1. Inviting Family Members
      2. Managing Family Members
    2. Messages
      1. Sending Recipes & Cookbooks
      2. Receiving & Importing Recipes
      3. Push Notifications
  19. Settings
    1. Accessing the Settings Panel
    2. List of Settings
    3. Account
      1. Paprika Cloud Sync
      2. Accessing your Account
      3. Creating an Account
      4. Logging In
      5. Managing your Account
      6. Quick Sync
      7. Deleting your Account
    4. Import Recipes
      1. YAML Format
    5. Export Recipes
      1. How to export your recipes
    6. Find Duplicates
  20. Extensions
    1. Saving Recipes from Safari
    2. Shortcuts
  21. Resources
    1. Technical Support
    2. Frequently Asked Questions
    3. Changelog