# Make

Source: https://frameleaf.app/docs/using/make/

The Frameleaf app for Make lets your scenarios react to your library and add to it. A scenario can start when a photo is ready or something is added to an album, then search photos, download them, make albums, add tags or upload new files into albums you chose.

Make runs on the internet, so it needs to reach your server over HTTPS. Use your own HTTPS address, which needs no Frameleaf plan, or Frameleaf's [remote access](https://frameleaf.app/docs/cloud/remote-access/), which needs a plan that includes it. A server that's only on your home network can't be used from Make.

## Install

The app ships as source for a private Make custom app, in `integrations/make` in the Frameleaf source. Whoever runs your Make organization adds it once:

1. In Make, open **Custom apps** and create an app called Frameleaf.
2. Paste each file into the matching tab of Make's app editor: `base/base.json` into **Base**, `connection/communication.json` and `parameters.json` into the connection, `scope.json` and `scopes.json` into the scopes, `groups.json` into **Groups**, and the files in `rpcs/albums` into a remote procedure. Leave **Common data** as `{}`.
3. For each folder in `modules`, add a module and paste its `communication.json`, `parameters.json` and `interface.json`, with the scope from its `module.json`.

The modules show in English. The connection's labels, help and errors come in all eleven Frameleaf languages.

## Register Make with your server

An administrator does this once per server:

1. Open **Settings**, then **Who can sign in**, then **Sign-in methods**. Under **Registered apps**, choose **Set up an app**.
2. Under **Name**, choose **Make**.
3. In **Sends you back to**, enter `https://www.make.com/oauth/cb/app`.
4. Choose **Create**, then copy the **App ID** and share it with people who use Make.

## Connect your library

1. In a scenario, add a Frameleaf module and choose **Create a connection**.
2. In **Frameleaf server URL**, enter your server's HTTPS address, such as `https://photos.example.com`, with no path. You can't change it later; make a new connection for another server.
3. In **Frameleaf client ID**, enter the App ID.
4. Frameleaf opens. Sign in if asked, choose the albums Make may read and the albums it may add to, and choose **Allow**.

A new connection only asks to see and search your photos, videos and albums. When you add a module that needs more, Make asks you to allow that too:

| Permission | Needed by |
| --- | --- |
| See and search your photos, videos and albums | Searches, **Get a photo or video**, **Download a photo**, **List albums** |
| Add photos to albums and make new albums | **Create an album**, **Add photos to an album** |
| Add tags to your photos | **Add tags** |
| Upload photos and videos to selected Photos albums | **Upload a photo or video** |
| Read updates from the albums you allow | **Watch events** |

Make never asks for original downloads, Boards, people, sharing or deleting.

## Modules

| Module | Type | What it does |
| --- | --- | --- |
| **Watch events** | Trigger | Starts when the **Event** you choose happens: **Photo or video ready**, **Added to an album** or **Studio export completed** |
| **Search photos and videos** | Search | Finds photos and videos in the albums you allowed |
| **List albums** | Search | Lists the albums the connection can use |
| **Get a photo or video** | Action | Gets one item's details |
| **Download a photo** | Action | Downloads a thumbnail, preview or display-size copy |
| **Upload a photo or video** | Action | Adds a new JPEG, PNG or MP4 file to an album you allowed |
| **Create an album** | Action | Makes an album |
| **Add photos to an album** | Action | Adds photos or videos to an album you allowed |
| **Add tags** | Action | Adds [tags](https://frameleaf.app/docs/using/tags/) to a photo or video |
| **Make a Connect API call** | Universal | Calls any Connect address under `/api/connect` with the same permissions |

**Watch events** takes up to 100 events a run by default, and at most 1,000. Frameleaf keeps the newest 1,000 events, and each one starts the scenario once.

**Create an album** and **Upload a photo or video** ask for a **Source ID**, a value that stays the same for the same item, such as a row or message ID. Running the same item again returns the same album or file instead of a copy. Uploads also ask for **Date taken**. An upload is sent in one piece, so it has to fit your server's upload limit. If one stops part-way, use a new Source ID.

When Frameleaf asks Make to wait, or is busy changing albums, Make retries the module on its own. If it says to reconnect, the connection's access was removed or ran out.

## Remove Make

Open **Settings**, then **Your sign-in & privacy**, then **Connected apps** in Frameleaf and choose **Remove** next to Make. Its scenarios stop working straight away. Deleting the connection in Make also asks Frameleaf to end access, but removing it in **Connected apps** is the way to be sure. Files Make already sent elsewhere stay there.

To change which albums Make may use, open **Details** for it in **Connected apps**. You can take albums away there; to add albums, reconnect.
