# Library and timeline

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

All your photos and videos live in one library, and Frameleaf gives you fast ways to browse it, pick out what you want and act on many photos at once. The **Library** entry at the top of the sidebar opens it, and the rest of the sidebar takes you to Explore (People, Pets, Memories, Places, Map, Tags, Folders and Documents), Albums, Shared spaces and Tools. **Library Care** sits at the bottom of the sidebar. On a phone-sized screen, a tab bar at the bottom offers Library, Memories, Albums and Search.

## Three layouts

The library has three layouts. Your filters, sort order, selection and scroll position carry over when you switch between them.

| Layout | Best for |
| --- | --- |
| **Browse** (the default) | A dense square grid with thin gutters and nothing but the pictures |
| **Timeline** | Rows that keep each photo's shape, with sticky day headers and grouping by day, month or year |
| **Work** | Going through a shoot: star ratings and rejects, the favourite heart, video length and badges always show, and an inspector panel opens beside the grid on wide screens. File names are off by default; turn them on in the [View menu](#the-view-menu) |

[![An album in Browse layout, with a photo grid, Timeline and Work layout choices, and album actions.](https://frameleaf.app/shots/docs/library-browse-2026-10.jpg)](https://frameleaf.app/shots/docs/library-browse-2026-10.jpg)

*Browse keeps the photographs front and centre. Switch layouts above the grid without leaving your album. Select the image to see the controls at full size.*

**Timeline** has a year-and-month scrubber beside the photos while they're in date order. Drag it to jump through your library; hovering shows the month and how many items it holds, such as "Oct 2025 · 7 items". Browse and Work have no scrubber, and you can hide Timeline's with **Year scrubber** in the [View menu](#the-view-menu).

### Work: click to look, click again to open

In **Work** on a wide screen, with the information panel showing, clicking a photo shows it in the panel beside the grid, with its rating, tags, a note, the people in it, when and where it was taken and its file details, so you can rate and tag without leaving the grid. Click the same photo again, or choose **View large** in the panel, to open it in the viewer. With several photos selected, the panel asks you to select one item to see its information.

### Group by day, month or year

Grouping is a **Timeline** control. **Timeline grouping** has **Years**, **Months**, **Days** and **All**; on a wide screen it sits in the toolbar after the layout tabs, and otherwise in a row of its own above the timeline. Hold Ctrl or ⌘ and scroll, or pinch on a trackpad or touch screen, to change it. The D, M and Y keys switch to Timeline with that grouping from any layout.

Years and Months appear as cards. Each card's cover is chosen by Frameleaf's best-photo score, then your rating, then the newest photo, and shows how many items it holds and its top places. Month cards add a strip of highlights.

Browse and Work can be grouped too: choose **Group by** in the [View menu](#the-view-menu).

### When and where

Each day in **Timeline** is headed by its date and, when its photos have a place, the towns and cities they were taken in: "Banff", "Banff and Lake Louise", or "Banff, Lake Louise and 2 more". On a phone the places sit on a line of their own under the date. Days grouped by **Day** in Browse or Work show the same places; month and year headings don't.

Under each photo in Timeline is the time it was taken. To see file names as well, or instead, use **Show on photos** in the [View menu](#the-view-menu).

[![The Library in Timeline layout. The day header reads Wednesday, October 9, 2019, then Banff and 15 items, and the time each photo was taken is under it.](https://frameleaf.app/shots/docs/library-when-where-2026-11.jpg)](https://frameleaf.app/shots/docs/library-when-where-2026-11.jpg)

*A day in Timeline says when and where, and each photo shows the time it was taken. Select the image to enlarge it.*

## The View menu

**View**, in the toolbar above your photos, holds the choices for how the Library looks. On a phone, or when the photo area is narrow, it shows just its eye icon, and it opens as a sheet at the bottom of the screen. The menu offers only what fits the layout you're in:

| Section | Choices |
| --- | --- |
| **Panels** | **Information panel**, the inspector beside the photos (not on phones), and **Year scrubber** (Timeline only, on by default) |
| **Photos** | **Size**: **Small**, **Medium** (the default) or **Large**, the same as the thumbnail size slider. In Browse and Work: **Crop photos to fit** (on by default) and **Group by**. On your library pages: **Stacks** |
| **Show on photos** | **Time taken** and **File name**, set separately for each layout. In Browse and Timeline: **Rating**, **Favorite heart** and **Video length and badges**, all on by default |
| **Library** | **Also show** |

A choice with an arrow, such as **Group by**, opens a page of its own inside the menu. Its current setting shows beside it, and the arrow at the top of the page takes you back:

- **Group by**: **None** (the default), **Day**, **Month** or **Year**. Sections follow the order you sort by, so sorting by file name or rating, or switching to the list, shows no sections. Timeline has its own Years, Months and Days.
- **Stacks**: **Keep stacks together** (the default) shows a burst or a set of versions as one photo with a count. **Show every photo** lays them all out.
- **Also show**: **Photos your partners share with you** (on by default; it names your partner when there's only one) and **Archived items** (off by default). Locked items never show here.

**Work** always shows ratings, the favourite heart, video length and badges, because you need them while you go through a shoot, so its menu doesn't offer those three switches. **Time taken** is on by default in Timeline and Work, and **File name** is off everywhere.

Your choices are saved to your account, so they follow you to your other devices. **Size** is the exception: it's saved on each device. **Reset view** at the bottom of the menu puts everything back to the defaults. A shared link always shows the defaults, whatever the visitor has chosen.

[![The Library in Browse layout with the View menu open: Panels, Photos with Size, Crop photos to fit, Group by and Stacks, Show on photos with five switches, Library with Also show, and Reset view.](https://frameleaf.app/shots/docs/library-view-menu-2026-11.jpg)](https://frameleaf.app/shots/docs/library-view-menu-2026-11.jpg)

*The View menu in Browse. Group by, Stacks and Also show open pages of their own. Select the image to enlarge it.*

## Dates to check

A photo whose camera clock was wrong can claim it was taken on 1 January 1970, or years in the future, and push itself to the top or bottom of your timeline. Frameleaf keeps these photos together under **Dates to check**, at the end of the timeline, so they never lead your library.

A date is counted as one to check when it's:

- more than a day in the future, or
- 1 January 1970, 1 January 1980 or 1 January 2000, the days a camera falls back to when its clock is reset.

A date you set yourself, with **Change date**, **Shift all by** or an accepted suggestion, is never counted, even if it's one of those days.

When your library has any, a notice above the timeline says how many and which years they claim, such as "112 photos have dates that can't be right (1970, 2000, and 2031). They wait at the end of the timeline until fixed." The group's heading reads **Dates to check**, with **The camera's clock was wrong** beside it. The group appears while the timeline is sorted by capture date, whether newest or oldest first.

[![The top of the Library timeline with a notice: 112 photos have dates that can't be right (1970, 2000, and 2031). They wait at the end of the timeline until fixed. A Fix dates button is at the end of the notice.](https://frameleaf.app/shots/docs/library-dates-notice-2026-11.jpg)](https://frameleaf.app/shots/docs/library-dates-notice-2026-11.jpg)

[![The end of the Library timeline: the Dates to check group, labelled The camera's clock was wrong, with 112 items.](https://frameleaf.app/shots/docs/library-dates-to-check-2026-11.jpg)](https://frameleaf.app/shots/docs/library-dates-to-check-2026-11.jpg)

*The notice at the top of the timeline, and the group waiting at its end. Select an image to enlarge it.*

### Fix dates

**Fix dates** in the notice asks what happened to the group's photos: **They were taken in another time zone**, or **The camera's clock was off**, to move each one earlier or later by the same amount, which keeps a burst in order. You see the first few before and after, and nothing changes until you choose **Fix**. To give them all one date instead, choose **Set one date and time instead…**, which opens **Change date**. Once a photo has a date that can be right, it leaves the group and takes its place in the timeline, and you can undo the fix for 30 days. See [Fix the dates of photos you choose](https://frameleaf.app/docs/using/date-and-time-doctor/#fix-the-dates-of-photos-you-choose).

These photos also stay out of the date range shown under an album, tag or folder. Where one holds any, a link beside its range says how many, such as **3 dates to check**. On an album or tag it works like **Fix dates**; on a folder it opens the timeline for that folder, with the group at its end. The same rule keeps these photos from deciding a [trip](https://frameleaf.app/docs/using/magic-albums/#how-it-decides) or an [on this day](https://frameleaf.app/docs/using/memories/#kinds-of-memories) memory.

For mistakes a camera date can't show by itself, such as a clock a few hours out or the wrong time zone, see the [Date & Time Doctor](https://frameleaf.app/docs/using/date-and-time-doctor/).

### Thumbnail size

Change the thumbnail size with a pinch, Ctrl and the scroll wheel, or the + and − keys. When nothing is selected, a status bar at the bottom shows how many items are in view and whether the view is saved on this device. While anything is selected, the selection bar takes its place and shows the count, with **Select all** and **Deselect**; the status bar comes back once you deselect.

## Select and change many at once

- Click a photo's check mark to select it. **Shift-click** selects everything in between, and clicking a day header selects that day. Nothing is selected when the page opens.
- The selection bar starts with the everyday actions: favourite, **Add to album**, **Share link**, **Send a copy…** where your browser can share files, download and delete. Then come **Compare**, **Quick edit**, **Make a movie** and **Open in Studio**, and **More** has the rest: stack, change date, [fix dates](https://frameleaf.app/docs/using/date-and-time-doctor/#fix-the-dates-of-photos-you-choose), description or location, archive, lock and tag. When the bar is short of room, its actions show as icons, each named when you point at it.
- **Right-click** a photo, or the selection, for the same everyday actions and the edits you use most: **Tag**, **Change date**, **Change location**, **Change description**, **Lock** or **Unlock**, **Archive**, **Stack**, and in an album **Set as album cover** and **Remove from album**. On a keyboard, Shift F10 opens it for the focused photo.
- To select everything that matches your current filters, not just what's loaded, choose **…** above the grid and then **Select all N matching items** in **View actions**, or click **Select all N** on the selection bar. Both show the count before you act. While it's active, the bar reads "N selected · Everything matching this view", and **Compare** and **Quick edit** aren't available.

### Undo a bulk action

After a bulk action, the selection bar and the message that appears offer **Undo**, named for the step that reverses it: favouriting offers "Undo: Remove from favorites". These actions can be undone:

- favourite and remove from favourites
- add to album and remove from album
- delete, which moves items to the trash and restores them on Undo
- stack and link Live Photo
- tag, which removes the tag only from the items that didn't already have it
- archive and unarchive
- unlock

Changing the date, description or location, locking, unstacking and unlinking don't offer Undo. Most actions on more than 500 items, and any action on everything matching, run in the background and don't offer Undo either. The exception is archiving everything matching in your own Library, which keeps its Undo.

### Compare

Select two or more photos and choose **Compare** to cull them side by side. The first photo you selected stays pinned on the left, and the rest come up on the right one at a time, with your position shown as "2 of 5".

- **Zoom both** zooms both photos at the same point, and you can also click a photo to zoom both there. Move the pointer to pan both, and choose **Show whole photos** to zoom out.
- **Keep** gives a photo five stars and **Reject** marks it rejected. Choosing the same decision again clears the rating. Deciding on the right-hand photo moves on to the next one, and nothing asks for confirmation.
- **Undo decision** puts back the rating a photo had before, one decision at a time, for your last 50 decisions.
- Choose **Done** to go back to the grid.

Keep and Reject only change ratings: nothing is stacked, moved or deleted. Because they're ordinary ratings, you can then find your picks with the **Exactly 5 stars** or **Rejected** filters in [Search](https://frameleaf.app/docs/using/search/#filters). Only the owner can keep or reject a photo; someone else's photo is shown but can't be decided.

### Keyboard shortcuts

Press **?** anywhere in the Library or the viewer to see every shortcut. Shortcuts pause while you type in a field.

[![The Keyboard shortcuts dialog, with General shortcuts for moving, selecting, grouping and switching layout, Actions such as Rate, Favorite, Edit, Stack, Add to album, Tag and Download, and shortcuts for albums in the sidebar.](https://frameleaf.app/shots/docs/keyboard-shortcuts-2026-11.jpg)](https://frameleaf.app/shots/docs/keyboard-shortcuts-2026-11.jpg)

| Key | Does |
| --- | --- |
| **X** | Select the focused photo |
| **←** **→**, and **↑** **↓** in the grid | Move between photos, or up and down a row |
| **Ctrl A** and **Ctrl D** (**⌘** on a Mac) | Select all, and clear the selection |
| **Shift T**, **Shift B**, **Shift W** | Show Timeline, Browse or Work |
| **D**, **M**, **Y** | In the grid, group by day, month or year. In the viewer, step a day, month or year forward or back |
| **G** | Go to a date |
| **/** | Search |
| **1** to **5**, and **0** | Rate, and clear the rating |
| **F** | Favourite or unfavourite |
| **I** | Show or hide Info |
| **E** | Edit |
| **S** | Stack the selection |
| **L** | Add to album |
| **T** and **P** | Tag, and tag people |
| **Shift A** | Archive or unarchive |
| **Shift D** | Download |
| **Space** | Play or pause a video, in the viewer |
| **Delete** | Move to the trash |
| **Esc** | Go back, close or deselect |

With an album focused in the sidebar, **Alt ↑** and **Alt ↓** move it up or down, **Alt →** puts it inside the album above, and **Alt ←** takes it out one level.

## The viewer

Open a photo to see it on a black background. Tap or click to hide the controls, and swipe down to close.

The title at the top says when and where the photo was taken, such as "Wed, Oct 9, 2019 · Banff, Alberta", and the line under it starts with the time, then the camera and its settings. Point at the title to see the file name. A photo with no place shows just the date.

**Info** opens as a panel on a computer or tablet and as a sheet on a phone. You can change the description, date and time zone, location, tags, rating and faces right there. Under **Details**, the file name, image size, camera, lens and exposure come first; the file's **Path**, **Bit depth** and **Checksum** wait under **File details**, which you open when you need them. For a photo with text in it, the panel ends with **Text in this photo**; see [Documents and text in photos](https://frameleaf.app/docs/using/documents/).

[![The photo viewer showing a family picnic, titled Wed, Oct 9, 2019 · Banff, Alberta, with the time, camera and settings under the title. The Information panel shows the date, the place, Details and a closed File details line.](https://frameleaf.app/shots/docs/viewer-when-where-2026-11.jpg)](https://frameleaf.app/shots/docs/viewer-when-where-2026-11.jpg)

*The viewer's title says when and where. File details sits at the end of Details. Select the image to enlarge it.*

### On a phone

On a phone, the viewer has a single bar along the bottom with its actions. **Play slideshow**, **Slideshow settings**, **Show filmstrip** and **Enter full screen** are in the **…** menu, in its **Viewer** group. A video or a panorama keeps a second bar for its own controls, such as **Original** and **Optimized** for a video, and so does a photo opened from a shared link.

The viewer's menu groups everything else you can do with the photo: **Download**, **Organize** (add to an album, archive, lock), **Stack**, **Set as** (album cover, a person's featured photo, your profile picture), **Go to** (its place in the timeline, similar photos, the map, its folder) and **Viewer**.

The viewer can also:

- cast to a TV, if you've turned on Chromecast (see [Casting to a TV](https://frameleaf.app/docs/using/casting/))
- copy the image
- play a video's original or its streaming version
- show a filmstrip, and look around panoramas, 360° photos and 360° video
- play a slo-mo slowed in the middle, as your phone does, and open a panorama filling the screen so you can drag across it (see [Photo and video types](https://frameleaf.app/docs/using/photo-and-video-types/))
- preview any moment of a video as you point at its seek bar, and scrub the picture as you drag (see [Video scrubbing and previews](https://frameleaf.app/docs/using/video-previews/))
- **Send a copy…** with your device's share sheet, up to 50 items and 500 MB at a time

### Zoom into a video

Zoom and pan work on videos as they do on photos, whether the video is playing or paused. Use the mouse wheel, pinch on a trackpad or touch screen, or double-click or double-tap to zoom to 2x at that spot and back. Drag the picture to move around it.

The **Zoom out**, **Fit** and **Zoom in** buttons at the bottom of the viewer show the zoom level, such as **150%**. **Fit** puts the whole video back in the window. On a phone they sit in a row of their own. On a keyboard, `+` and `-` (or `z`) step the zoom and `0` fits the video again.

The playback controls, seek bar and captions stay the same size and in place while you zoom. Every video opens fitted, and leaving a zoomed video resets it. While a video is zoomed in, swiping doesn't move to the next item, so you can pan freely. Zoom isn't available for 360° videos or while casting to a TV. Zooming only changes your view: the video file isn't changed.

A photo whose original is missing, or whose file is damaged and couldn't be repaired, shows **Original missing** or **Damaged file** at the top of the viewer. Select it to see what Frameleaf tried and what you can do. See [Damaged and missing files](https://frameleaf.app/docs/using/damaged-and-missing-files/#in-the-photo-viewer).

How the viewer behaves is up to you. **Show full-quality photos**, **Play the original video file**, **Start videos by themselves** and **Repeat videos** are in your preferences; see [Photos and videos](https://frameleaf.app/docs/using/account-settings/#photos-and-videos).

### Slideshow

Start a slideshow from the viewer or an album. Its settings panel opens over the corner of the slideshow, so you see each change on the next photo:

| Setting | Choices |
| --- | --- |
| **Photo duration** | 2, 3, 5 (the default), 10, 15 or 30 seconds. Videos play to their end |
| **Image fit** | **Fit entire photo** (the default), **Fill screen** or **Blurred background** |
| **Caption** | **Off** (the default), **Description**, or **Description & details** |
| **Order** | **Ascending**, **Descending** (the default) or **Shuffle** |
| **Transition** | **None**, **Fade** (the default), **Slide**, **Ken Burns** or **Memories** |

You can also turn on **Repeat collection** to start again at the end, and turn off **Autoplay slideshow** or **Show progress bar**. The screen stays awake while it plays, and Reduce Motion switches transitions to fades.

## Archive

Archive a photo to take it out of your library without deleting it: select it and choose **Archive**. It moves to **Archive** in the sidebar, and stays out of the timeline and, unless you choose otherwise, out of [search](https://frameleaf.app/docs/using/account-settings/#browsing) and [People](https://frameleaf.app/docs/using/people/#archived-photos-in-people). To see archived photos in the Library alongside the rest, turn on **Archived items** under **Also show** in the [View menu](#the-view-menu). With nothing archived, the Archive page says **Nothing archived**: "Photos and videos you archive leave your library and wait here."

For photos that should stay private behind a PIN, use [Locked](https://frameleaf.app/docs/using/private-content/) instead.

## Folders

**Folders** shows your originals the way they're stored on disk, with a folder tree on one side and the photos and videos in the selected folder on the other. A path above the photos lets you click your way back up.

Folders is handy when you keep a carefully organised [external library](#photos-from-external-libraries) or your server uses a tidy storage layout. It's on by default. To turn it off, or to take it out of the sidebar, go to **Settings**, then **Your preferences**, then **Tools & sidebar**, and change **Use** or **Show in sidebar** in the **Folders** row.

## Photos from external libraries

Your administrator can add folders that already exist on the server, such as a NAS share of old photos, as an **external library** that belongs to your account. Its photos and videos appear in your timeline and behave like any others: you can open them on the map, add them to albums, favourite and tag them.

A few things work differently:

- **Frameleaf reads the files where they are.** New or changed files appear after the next library scan. Scans run every night by default, and your administrator can run one at any time.
- **A file deleted from disk goes to your trash** at the next scan, with a note. Put the file back and the next scan brings the item back; the trash can't restore or delete it for you. See [Trash and large files](https://frameleaf.app/docs/using/trash/#what-the-trash-shows).
- **Albums, descriptions and other changes you make are kept in Frameleaf**, and in an `.xmp` sidecar when the folder is writable. If a file is moved to another folder inside the library, Frameleaf treats it as a new item and those changes are lost. See [XMP sidecars](https://frameleaf.app/docs/using/xmp-sidecars/#external-libraries).
- **Read-only folders can't be changed from Frameleaf**, so you can't delete those files from the web app.

Setting up external libraries is an administrator job; see [External libraries](https://frameleaf.app/docs/admin/external-libraries/).

## Uploads, downloads and the trash

- **Upload** files or a folder from the top bar, or drag them onto the page. **Download** gives you an item's current, edited version, and **Download original** the untouched file. See [Uploads and downloads](https://frameleaf.app/docs/using/uploads-and-downloads/).
- Deleted items wait in the **trash** for 30 days by default, and **Large files** helps you find what takes the most space. See [Trash and large files](https://frameleaf.app/docs/using/trash/).

### While new photos are getting ready

After a big import, new photos can appear in the library before their thumbnails are made. Each one shows as a softly moving placeholder at its own size, and the picture fills in by itself when it's ready, without a reload. A video shows its length once it's known.

If Frameleaf can't make a photo's thumbnail, because its file is missing or damaged, the tile says **Can't show this photo** along the bottom. Select it to open [Library Care](https://frameleaf.app/docs/using/library-care/), or select the tile itself to open the photo. To follow a large import as it goes, see [Activity](https://frameleaf.app/docs/using/activity/#the-import-line).

## Supported formats

| Kind | Formats |
| --- | --- |
| Photos | Animated PNG, AVIF, BMP, GIF, HEIC and HEIF, JPEG (including JFIF and `.insp`), JPEG 2000, JPEG XL, MPO, Netpbm, PNG, PSD, Radiance HDR, RAW, SVG, TIFF, WebP |
| Videos | 3GP, ASF, AVI, camcorder `.mod` and `.tod`, DivX, DV, FLV, M4V, MKV, MOV, MP4, MPEG, MPEG-TS (`.mts`, `.m2ts`, `.ts`), MXF, Ogg, RealMedia, WebM, WMV, and 360° video from DJI (`.osv`), GoPro (`.360`) and Insta360 (`.insv`) |

Live Photos and Android motion photos are kept as one item that plays its motion clip. The full list is in [Supported formats](https://frameleaf.app/docs/help/supported-formats/), and [Photo and video types](https://frameleaf.app/docs/using/photo-and-video-types/) covers slo-mo, panoramas, bursts, 360° and Log video.

### RAW files

Frameleaf makes previews and thumbnails for camera RAW files. **Enhanced RAW rendering** is on by default: it uses the preview a camera embeds in the RAW file first, and makes a full render from the RAW data when it needs one. This helps difficult files, such as some `.cr2` files, get usable previews. Your administrator can change it in the server's image settings.

A RAW file the server can't read isn't treated as damaged. [Library Care](https://frameleaf.app/docs/using/library-care/#damaged-files) lists it separately, so you can tell an unsupported file from a broken one.

## Your originals are never changed

Frameleaf never changes your original files. Edits are saved as new versions (see [Editing](https://frameleaf.app/docs/using/editing/)), and descriptions, ratings, dates, locations and tags you change are written to an `.xmp` sidecar file next to the original (see [XMP sidecars](https://frameleaf.app/docs/using/xmp-sidecars/)).

When a file is damaged, Frameleaf may repair it by itself. The repaired copy takes its place in your library, and the damaged file is kept beside it, so **Undo repair** puts it back. See [Damaged and missing files](https://frameleaf.app/docs/using/damaged-and-missing-files/).
