# Files

> Find every picture, clip and note in a project, see where each one came from and where it is used.

**Files** holds everything a project owns: uploads, generated images and clips, and its Markdown notes. Use the switch at the top left of the page bar to move between the **Media** shelf and the **Markdown** shelf, and pick a file to see its details on the right.

## File

The file's name and what it is: kind, size, dimensions and format. Rename it here; the rest comes from the file itself.

1. Open **Files** in a project and pick a file from the grid or table.
2. The details panel opens on **Details** with **File** at the top.
3. Click **Name** to rename the file.

| Row        | What it shows                                        |
| ---------- | ---------------------------------------------------- |
| Name       | What the file is called in Rasu AI. You can edit it. |
| Filename   | The name it was saved under.                         |
| Kind       | Image, video, audio and so on.                       |
| Dimensions | Its size in pixels, or its length for a clip.        |
| Size       | How much space it takes.                             |
| Format     | The file type.                                       |

**For agents**

- `library_write (type: media_update)` — fields: `mediaId`, `name`, `filename`

## Provenance

Where this file came from: uploaded, or made by which model and who ran it. A file made outside Rasu AI shows that service, model and job as reported when it was brought in, unchecked and at no cost.

1. Pick a file and look under **File** in the details panel.
2. Read where it came from and who made it.

| Row                | What it shows                                                                  |
| ------------------ | ------------------------------------------------------------------------------ |
| Source             | Uploaded, generated, imported, or external: made by a service outside Rasu AI. |
| Provider and Model | Which service and model made it.                                               |
| Job                | For an external file, that service's own job id.                               |
| Seed               | The number that lets the same run be repeated.                                 |
| Version            | Which run this is, out of how many.                                            |
| Inputs             | How many pictures it was made from.                                            |
| Created by         | Who made it, and the assistant if one did it for them.                         |

### Files made outside Rasu AI

An assistant connected to Rasu AI can generate a shot or a look on another service and bring the result back. It goes in this order:

1. The assistant asks Rasu AI to prepare the shot or look for that service. Rasu AI answers with the prompt in plain words and a link to each reference. The links stop working after about 15 minutes.
2. The assistant generates on the other service, with its own connection to it. Rasu AI doesn’t generate here, never signs in to that service, and charges no credits.
3. The assistant gives Rasu AI the finished file’s link. Rasu AI brings the file in, and it shows in the jobs tray while it arrives.
4. The file becomes a take of the shot, or a new picture of the look. A look only takes pictures.

The Provenance card shows the service, its model and its job id as the assistant reported them. Rasu AI doesn’t check them. The prompt and references sent are on the take or look picture. Another service’s links often expire within days, so bring a file back soon after it’s made. There’s no button for this in the studio. To add a file you have yourself, use &#x2A;*Import a take…** or upload it.

**For agents**

- `library_write (type: media_fetch)` — fields: `address`, `external.service`, `external.model`, `external.jobId`, `destination`

## Live assignments

Every place this file is used right now, and in what role. Pick a row to go there.

1. Pick a file and switch the details panel to **Where used**.
2. Read each place the file is used and the role it plays there.
3. Click a row to go to that place.
4. If the file is also used outside this project, a note says so. Archiving it reaches those places too.

* **Role**: what the file does there, such as a take or a reference.
* **Place**: the shot, asset or sequence using it. A row marked "outside" belongs to another project.

## History

What happened to this file and who did it, newest first.

1. Pick a file and switch the details panel to **History**.
2. Read what changed and who did it, newest first.

* **Each entry**: one change, with who made it and when.

## Selection

What the files you picked add up to: how many, their size, and the tags they share. Download saves each one.

1. Tick more than one file, or Shift-click to pick a run of them.
2. The details panel shows **Selection** for the whole group.
3. Press **Download** to save each file, or use the ⋯ menu to archive or delete them together.

| Row            | What it shows                                                    |
| -------------- | ---------------------------------------------------------------- |
| Files          | How many you picked.                                             |
| Combined size  | Their total size. A note says if some have no size recorded yet. |
| Shared         | How many are also used outside this project.                     |
| Tags in common | Labels every picked file carries.                                |

## Markdown

The project's notes and instruction files, by path, with every version each has had. They arrive from a synced folder or from an assistant.

1. On **Files**, switch the page bar to **Markdown**.
2. Search by path, then pick a file to read it on the right.
3. Switch the panel to **History** to see every version, and pick one to read it.
4. Use **List options** beside the heading to show archived files.

| Column     | What it shows                       |
| ---------- | ----------------------------------- |
| Path       | Where the file sits in the project. |
| Version    | Its current version number.         |
| Changed by | Who last changed it.                |
| When       | When that was.                      |
| Size       | How long the file is.               |

**For agents**

- `project_story (type: file_write)` — fields: `projectId`, `path`, `baseVersion`, `text`

## This computer

Whether this project's Markdown files are kept in a folder on this computer, and anything that needed merging. Only shows in the desktop app.

1. Open Rasu AI in the desktop app and go to the **Markdown** shelf.
2. Turn on **Keep on this computer** in the page bar.
3. Read **This computer** at the bottom left to see whether the folder is up to date.
4. Press **Show in Finder** to open the folder.

* **Status**: syncing, up to date, waiting to sign in, or stopped.
* **Folder**: where the files are kept on this computer.
* **Notices**: files that were merged, clashed or could not be kept in step, with when it happened.
