Breaking Free from Paprika: What .paprikarecipes Files Actually Are

6 min read

Breaking Free from Paprika: What .paprikarecipes Files Actually Are

Paprika Recipe Manager is a genuinely good app. It has a clean interface, reliable syncing, and solid recipe clipping from websites. Depending on the platform, it costs somewhere between $5 and $30 -- reasonable for what you get. Plenty of home cooks swear by it, and for good reason.

But if you have ever tried to take your recipes somewhere else, you have probably run into its one major friction point: the .paprikarecipes file format. It is proprietary, undocumented, and no other application can read it natively.

That does not mean your recipes are trapped, though. Once you understand what is actually inside that file, getting your data out is straightforward.

What Is a .paprikarecipes File?

Despite the custom extension, a .paprikarecipes file is not some exotic binary format. It is a standard ZIP archive. If you renamed one to .zip and opened it, you would see a collection of individual files inside -- one for each recipe.

Each of those individual recipe files is gzip-compressed JSON. Decompress one, and you get a plain-text JSON object with fields like name, ingredients, directions, prep_time, cook_time, servings, source, source_url, categories, rating, notes, nutritional_info, and image_url.

In other words, the structure is: ZIP containing gzip-compressed JSON files. That is it. No database, no encryption, no obfuscation. The format is proprietary only in the sense that Paprika does not publish a spec and no other app has adopted it -- not because the data is hidden or inaccessible.

What Data Lives Inside Each Recipe

Here is a representative look at the fields Paprika stores for each recipe:

  • name -- the recipe title
  • description -- a brief summary or headnote
  • ingredients -- a newline-separated list of ingredients
  • directions -- step-by-step instructions, also newline-separated
  • prep_time and cook_time -- timing information as human-readable strings like "30 minutes" or "1 hour 15 minutes"
  • total_time -- the combined time
  • servings -- yield information
  • source and source_url -- where the recipe came from
  • categories -- tags or folders you have assigned
  • rating -- your personal star rating
  • difficulty -- if you have set one
  • notes -- your personal annotations
  • nutritional_info -- nutrition data if available
  • image_url -- a link to the recipe photo

This is a rich set of data. Paprika captures more metadata than many recipe apps do, which is part of what makes it useful -- and part of what makes losing that metadata during a sloppy migration so frustrating.

What Happens When MoveMyRecipes Parses It

When you upload a .paprikarecipes file to MoveMyRecipes.com/paprika, here is what happens behind the scenes:

  1. The file is opened as a ZIP archive.
  2. Each entry in the archive is decompressed from gzip.
  3. The resulting JSON is parsed and validated.
  4. Every Paprika field is mapped to its Schema.org equivalent. For example, ingredients becomes recipeIngredient, directions becomes recipeInstructions (as an array of HowToStep objects), and timing strings like "1 hour 30 minutes" are converted to ISO 8601 durations like PT1H30M.
  5. Fields that Schema.org does not have a direct equivalent for -- like difficulty, notes, and rating -- are preserved as custom fields (prefixed with x-) so nothing gets lost.
  6. The original Paprika data is also stored alongside the normalized version, so a lossless round-trip is possible.

The parser handles edge cases too. Some .paprikarecipes files contain plain (uncompressed) JSON entries instead of gzipped ones. Single-recipe exports are sometimes just a gzip file without the ZIP wrapper. The parser tries both approaches.

What Transfers and What to Watch For

The good news: nearly everything in a Paprika export transfers cleanly. Recipe names, ingredients, instructions, times, servings, categories, source URLs, ratings, notes, and nutritional information all come through.

A few things to be aware of:

Images are referenced, not embedded. Paprika stores an image_url field pointing to the original photo location (usually the website the recipe was clipped from). If that URL is still live, the image is accessible. If the source site has changed or removed the page, the image link may be broken. Paprika does store images locally on your device, but those local copies are not included in the export file.

Ingredient structure is flat. Paprika stores ingredients as a plain newline-separated string. There is no structured breakdown into quantity, unit, and item. MoveMyRecipes preserves the ingredient lines exactly as Paprika stores them, and each export format handles them appropriately -- but do not expect automatic parsing of "2 cups flour" into separate quantity/unit/name fields.

Categories may need cleanup. Depending on how you organized recipes in Paprika, categories might come through as comma-separated strings or arrays. Both are handled, but you may want to review how they map to whatever system you move to next.

Your Seven Export Options

Once MoveMyRecipes has parsed your Paprika file, you can export to any of seven formats:

  • JSON -- Schema.org-compliant, ideal for importing into other apps or self-hosted tools like Mealie or Tandoor Recipes
  • CSV -- opens in Excel, Google Sheets, or any spreadsheet application
  • Markdown -- perfect for note-taking apps like Obsidian, Notion, or just plain text files
  • CookLang -- the open-source .cook format from cooklang.org, designed for plain-text recipe storage
  • PDF -- formatted recipe cards ready for printing or sharing
  • HTML -- styled, self-contained web pages for each recipe
  • Open Recipe Format -- YAML-based open standard with structured ingredient data

The whole process is free, requires no account, and files are automatically deleted after seven days. You can wait on the page for real-time progress or provide an email address and get notified when the conversion finishes.

Being Fair to Paprika

It is worth saying plainly: Paprika is not a bad app. It is well-built, reasonably priced, and has been reliable for many users over many years. The proprietary format is a real limitation, but it is not malicious -- it is just a design choice that prioritizes their own ecosystem.

The issue is simply that your recipes are yours. Whether you are switching to a different app, moving to a self-hosted solution, creating a backup in a universal format, or just want the peace of mind that comes from not depending on a single vendor -- you should be able to get your data out in a format that works everywhere.

That is what MoveMyRecipes does. Upload your .paprikarecipes file, pick the format you need, and download the result. No tricks, no upsells, no account required.

Head to movemyrecipes.com/paprika to get started.

Ready to move your recipes?

Export and convert your recipe collection for free. No account required.

Convert My Recipes