Cookbook

The contents of a player's cookbook are displayed on the Foldit website.

The cookbook is where players' recipes are stored in Foldit.

The cookbook has always been a part of Foldit, but the details of how it works have changed with the launch of the new Foldit website in September, 2022. See 101 - Cookbook for the the "classic" version of the cookbook.

In the current, or "modern" version of the cookbook, all cookbook maintenance happens on the Foldit website, https://fold.it.

A player's "My Cookbook" page can be found at https://fold.it/recipes/library. (You must be logged in to fold.it so see this page.)

For players who used the classic cookbook, the "Import Cookbook" button can migrate an existing cookbook file (all.macro) to the new system.

Under "Recipes" on the Foldit website, clicking the "+" icon adds a recipe to the player's cookbook.

All players can browse recipes on the Foldit website, where clicking a "plus" icon (circled "+") adds the recipe to the cookbook.

The contents of the cookbook are automatically synchronized to Foldit each time game starts. A "refresh" button in Foldit also synchronizes the cookbook with the version on the website, without requiring a restart.

The synchronization feature eliminates the need to copy all.macro when using multiple separate Foldit clients.

Cookbook import

In the modern Foldit system, all players start with empty cookbooks. Players who already had cookbooks in classic Foldit can import them into the new system.

Cookbooks were previously not stored on the Foldit website. Recipes resided in the all.macro file associated with each Foldit. (For example, c:\Foldit\all.macro is a typical location on Windows.)

A player's cookbook starts out empty.

Under "My Cookbook" (https://fold.it/recipes/library), the "Import Cookbook" button opens a dialog that prompts for the location of an all.macro file. The user must navigate to c:\Foldit or wherever Foldit is installed to locate all.macro. Then clicking on the "Import" button uploads the content of the all.macro cookbook.

The Import Cookbook dialog lets the user browse for an all.macro file.

There are some restrictions on which recipes can be imported:

1. recipes must have been shared on the Foldit website -- recipes loaded to the cookbook from files won't be imported
2. only recipes written in Lua V2 can be imported
3. GUI recipes are no longer supported, and won't be imported
4. recipes written in Lua V1 are no longer supported, and won't be imported
5. for players who have left a group, recipes shared to that group won't be imported, except for a player's own recipes

A "classic" cookbook is shown on the left, and a "modern" cookbook is on the right. Messages from the "Import Cookbook" dialog appear in the center. In this case, two recipes were not imported, since they were either GUI or Lua V1.

In the example shown here, recipes in the "cookbook starter pack" were added to an empty cookbook in classic Foldit. A Lua V1 recipe (Stabilize 2.0.4) and a GUI recipe (Co lapse's Settle) were also added. The starter pack recipes were automatically placed in a folder called "Starter Pack".

During the import, the Lua V1 recipe and the GUI recipe were not imported. The remaining recipes were successfully imported. All the recipes are now found in under the "Starter Pack" folder.

If the "classic" version of Foldit is still available, any recipes not imported can at least be viewed using the recipe editor. Lua V1 and Lua V2 recipes can be exported to files. The files can then be pasted into new recipes on the Foldit website.

The Python program MacroScanner is also available. MacroScanner works with an all.macro file. It can convert GUI recipes to simple Lua V2. It can also extract Lua V1 and Lua V2 recipes. MacroScanner needs only all.macro, and doesn't depend on whether classic Foldit is still running.

For V1 recipes, rav3n_pl's FolditLuaConverter is a Windows program which converts recipes using the V1 functions to the V2 equivalents.

"My Cookbook"

Among other functions, the "My Cookbook" page lets players adjust the folder in which recipes are stored.

Players can adjust their cookbooks on the Foldit website, using the "My Cookbook" page under "Recipes".

The "My Cookbook" page allows sorting the cookbook by recipe title, recipe author name, recipe date, and which folder the recipe is stored in. Recipe likes and popularity also appear as sortable columns.

A "minus" icon on the "My Cookbook" page allows a recipe to be deleted from the cookbook. Recipes can added to the cookbook under the main "Recipes" section, where a corresponding "plus" icon is found.

For recipes written by the cookbook's owner, "My Cookbook" allows editing the recipe by clicking the "pencil" icon. Otherwise, the recipe can be located and viewed in the main "Recipes" list.

"My Cookbook" allows changing which folder a recipe is stored in. Folders can be named, and there is also a "no name" folder. In the Foldit game client, the "no name" folder appears first, followed by other folders in alphabetic order. Recipes appear in alphabetic order within each folder.

The Cookbook Window

Hovering over the name of a recipe shows the magnifying glass icon. Clicking this icon opens the recipe's web page in a browser. The web page now displays the recipe's source code.

In the Foldit game client, the cookbook appears as floating window which can be opened, closed, moved, and resized vertically and horizontally. The general behavior is similar to the cookbook in the most recent versions of classic Foldit.

The current cookbook is streamlined as compared to previous versions. As before, clicking on a recipe runs that recipe. Only a limited number of other functions are available.

Hovering over the name of a recipe reveals a "magnifying glass" icon, which opens the recipe's web page. (All recipes in the cookbook are now guaranteed to have a page on the Foldit website.) The hover action also shows a "play" icon, which is an alternate way to run the recipe.

The cookbook window itself has only three actions. There is a "recycle" icon, which refreshes the cookbook with the current version from the website. There is a "DOS prompt" icon, which displays the recipe output window. And there is a "network folder" icon for "load local recipe", which allows loading and running a recipe from a file.

The modern version of the cookbook window no longer allows deleting recipes or moving them to different folders. There is no way to create a new folder or delete an existing one. There is no way to add a recipe by recipe number, or change the font size used by the cookbook.

Most critically, the modern cookbook no longer has a recipe editor. Recipes can be edited directly on the Foldit website. For recipes already in the cookbook, the magnifying glass icon is now a quick way to see the recipe's source code.