# Projects, Media Library & Stock

How to manage projects and your image/video library in Framo — create and open projects, save your work, upload and organise media, pull in free stock photos, and move media onto the canvas.

## The Dashboard

The Dashboard is your home base. Open it from the top bar **Dashboard** link. The left sidebar groups everything:

- **Overview** — landing summary.
- **Projects** — your canvases.
- **3D Models**, **Images**, **Videos**, **LoRAs** — your media libraries.
- **Bin** — deleted items (recoverable for 30 days).
- **Tools** — Lora Training, 3D Compression.
- **Account** — at the bottom.

## Projects

A project is one infinite-canvas workspace. Each project lives in the dashboard **Projects** section.

To create a project: in **Projects**, click **New Project** (top right). This opens a fresh editor canvas.

To open an existing project: in **Projects**, double-click its card (or use its **⋯** menu / right-click → **Open**). Inside the editor you can also press **Ctrl+O** to open the project picker.

To rename a project: right-click the card (or **⋯** menu) → **Rename**, or double-click the project name on the card. Press **Enter** to confirm, **Esc** to cancel.

To delete a project: right-click the card (or **⋯** menu) → **Delete**. This moves it to the **Bin** (see below); it is not erased immediately.

To find a project: use the **Search projects...** box. Filter with the **All / Shared / On Drops** badges. Toggle card density with the grid buttons next to the search box.

> Each project card also has **Share Options** for sharing/publishing — see [Sharing, public viewer & Drops](/docs/product/sharing-drops).

### Saving

Framo autosaves the canvas continuously — changes are written automatically a few seconds after you stop editing (deletions save immediately), and pending changes are flushed when you switch away or close the tab. To save manually at any time, press **Ctrl+S**.

## Media Library (Images & Videos)

Your generated, rendered, and uploaded media live in the dashboard **Images** and **Videos** sections (3D models have their own **3D Models** section).

Each section gives you:

- **Search** — the search box matches names, prompts, models, dimensions, projects (and for videos: formats, duration).
- **Filter badges** — **All**, plus for images: **Upscaled**, **AI Generated**, **Rendered**, **Uploaded**, **Favorites**; for videos: **AI Generated**, **Uploaded**, **Favorites**. Each badge shows a live count.
- **Filter by project** — click the project filter (folder) chip in the badge row to show only one project's media.
- **Group by** — toggle **date** / **project** grouping with the calendar / folder buttons.
- **Grid density** — toggle **Normal** (4 columns) / **Compact** (8 columns) with the layout buttons.

To favourite media: hover a tile and click the sparkle icon (top-right). Favourites are filterable with the **Favorites** badge.

To open media full-size: double-click a tile.

To download an image: right-click → **Download** (or the tile's **⋯** menu).

### Uploading

To upload images: in **Images**, click **Add Image**, then drop files onto the dialog or click to browse. You can upload up to 20 at once; files over 3MB are auto-compressed and large images downscaled to 2048px.

To upload a video: in **Videos**, click **Add Video** → **Choose Video File**, then **Add Video**. Max 256MB; mp4/webm/avi/mov/mkv.

> Uploading requires an active plan. Without one the Add buttons are locked.

### Deleting & bulk delete

To delete one item: hover a tile → **⋯** menu (or right-click) → **Move to Bin**.

To bulk-delete: click tiles to select multiple (Shift-click for a range), then right-click a selected tile → **Move N selected to Bin**. Press **Esc** or click empty space to clear the selection.

Deleting moves items to the **Bin** — it doesn't erase them right away.

## Bin (deleted items)

Open the **Bin** from the sidebar. It holds deleted images, videos, 3D models, and projects. **Items are automatically deleted after 30 days** (each tile shows days remaining).

- Filter by type with the **All / Images / Videos / 3D Models / Projects** badges.
- **Restore**: hover a tile → **Restore**.
- **Delete permanently**: hover a tile → **Delete** (irreversible).
- **Empty Bin**: top-right button permanently deletes everything in the bin.

## Stock Images (Unsplash + Pexels)

Framo can search free stock photos from **Unsplash** and **Pexels** and save them straight into your library.

To browse stock: open the **Add Image** dialog (in the editor's image picker), then switch the top tab from **My Images** to **Image Library**. Search across both providers in the **Search Unsplash + Pexels...** box, and narrow to one source with the **All / Pexels / Unsplash** chips.

To save stock photos: click photos to select them, then **Add Selected (N)**. They import into your library (and onto the canvas when opened from the canvas). The dialog stays open so you can keep browsing.

## Moving Media Between Library and Canvas

Inside the editor, the **floating media panel** (the in-canvas library) shows a **unified feed** of your images, videos, and 3D models together.

- **Search** generations, **filter** by **Favorites / Images / Videos / 3D Models / Composites**, and **filter by project** via the folder chip.
- Toggle between **single** and **grid** view with the layout button.
- Double-click a tile to open it full-size.

To put media on the canvas: in infinite-canvas mode, **drag a tile from the media panel onto the canvas**. Images, videos, and 3D models can all be dragged in.

To add media via the picker: when a tool asks for an image (e.g. image-to-image, reference, inpaint), the **Add Image** dialog opens — pick from **My Images**, filter by **This Project / Favorites / AI Generated / Uploaded / Upscaled**, upload a new file, or grab a stock photo (see above).

> Generated images carry a **Go to Project** link in their tile menu that jumps back to the canvas they were made on.

## Textures (for 3D)

When working on a 3D model, you assign textures per material map slot. Opening a material map's **texture picker** lets you choose from your existing images/textures or **upload** a new texture file, then **Select** it to apply it to that map. See [3D scene editor](/docs/product/editor-3d).
