k1nq/TREK
1
0
Fork 0
mirror of https://github.com/mauriceboe/TREK.git synced 2026-11-05 04:04:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add wiki pages for the AI assistant, AI connections and TREK Studio

Browse Source 
The assistant, the shared AI connection and the Studio editor had no page of
their own; these describe them from the current screens and limits.
This commit is contained in:
Maurice
2026-10-24 23:27:29 +02:00
parent 6434fe7a3c
commit 982861264e
3 changed files with 415 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
wiki/AI-Assistant.md
+120
View File
@@ -0,0 +1,120 @@
# AI Assistant
The assistant is a chat inside TREK that knows your trip. Ask it what is still open, let it plan a day, find somewhere to eat near the hotel or turn a booking confirmation into a booking. It reads your plan the way you see it and answers in words, cards and places on the map. **Nothing in your trip changes until you confirm it**: every change the assistant wants to make arrives as a card with **Apply** and **Discard**, and an applied change can be undone.
The assistant runs on an AI model from a provider you or your administrator connect, such as Anthropic, OpenAI, Gemini, OpenRouter, a ChatGPT plan, or a model server of your own. Setting that up is explained in [AI-Connections](AI-Connections).
> **Admin:** The assistant is the **AI Assistant** addon. It is off by default. In **Admin → Addons** it sits on the **AI** tile together with AI Parsing and MCP; switch it on there and set up the connection with **Set up AI**. See [AI-Connections](AI-Connections#for-administrators) and [Admin-Addons](Admin-Addons).
## Where the assistant runs
| Where | What it is about | What it may change |
|---|---|---|
| In a trip | That trip: its days, places, bookings, transports, costs, lists, tours, road trip and collab | Everything you may change in the trip yourself, after you confirm |
| Outside a trip (the home chat) | All your trips at once, plus your Atlas, Vacay and journals | Nothing. It reads, compares and answers, and hands you over to a trip's own chat |
| In [TREK Studio](TREK-Studio#the-book-assistant) | One journey and its photo book | The book's pages, layouts and theme, after you confirm |
The assistant appears only once a connection you can use is set up. Until then there is no button for it, so nobody is shown a feature they cannot use.
## Opening it
- **On the desktop**, the **Assistant** button in the navigation bar opens and closes it, and in the trip planner a round button floats at the bottom of the screen. **Ctrl+K** (**⌘K** on a Mac) does the same anywhere, except while a dialog is open.
- **On a phone**, a trip's **More** sheet starts with **Ask TREK** (*Plan with the assistant*), and outside a trip **Assistant** leads the **More** list of the bottom bar. The dashboard has an assistant button at the top as well. See [Mobile-App](Mobile-App).
- **From the planner**, a right click on a place offers **Find an alternative** and **Restaurant nearby**, and one on a day offers **Plan this day** and **Plan for rain**. The place details have an **Ask** button. Each of these opens the chat with that place or day as its subject and sends the question straight away.
On the desktop the assistant is a window floating over the app. Drag it by its head, resize it from any edge or corner, and let go near a corner to make it settle there. A double click on the head switches between a compact and a large window, and **Alt+arrow keys** move it (**Alt+Shift+arrow keys** resize it). The window remembers where it was. Closing it only hides it: an answer still being written carries on, and the round button breathes until it is done. **Escape** first stops an answer, then closes the window.
## Asking
Type into **Ask anything about** *your trip* and press **Send**. While an answer is being written, **Stop** ends it.
- **Suggestions.** An empty chat offers questions that fit the moment, such as *Plan the first days for me* before the trip, *What's on today?* during it, or *Sum up our trip* after it.
- **Mentions.** Type **@** to pick a day, a place or a booking of the trip, and the assistant knows exactly which one you mean. You can also drag a place from the sidebar or the map into the chat.
- **Steps.** While it works, the chat shows what the assistant is doing (*Reading your plan*, *Searching for places*, *Checking the weather*) and folds the steps away once the answer is there.
- **Ask next.** Under an answer come a few follow ups that fit it, for example *Only cheaper ones* or *Plan the next day the same way*. One click sends it.
- **Web search.** When the administrator allows it and the provider supports it (ChatGPT, Anthropic and OpenRouter), the assistant can look things up on the web, such as reviews, opening times or events. The answer then lists its **Sources**.
**Recent chats** in the window's head lists your earlier conversations, and **New chat** starts another. Your chats are your own: other trip members never see them. A chat you no longer want goes with **Delete chat** in the **More options** menu.
### Trip notes
The assistant can remember things about a trip for every later conversation: *we eat vegetarian*, *we travel with children*, *no early mornings*. When it keeps something, the chat shows **Noted for this trip:** and the note. **Edit trip notes** in the **More options** menu opens the full list, with a row of **Common wishes** to tick and a field for your own words. Trip notes are yours, per trip, and are not shown to other members.
### Hints
The assistant looks over the plan on its own and lists what is **Worth a look**: two things that overlap, a place that is closed on the day you planned it or opens too late, a long gap in a day, a leg that is far or tight, nights with nowhere to stay yet, and bookings that are not on any day. Each hint is one click away from a question about it, and **Hide this hint** puts one away. The launcher shows how many hints are waiting; **Stop showing hints** in the **More options** menu switches them off.
## Suggested changes
When the assistant wants to change something, it does not do it. It shows a **Suggested changes** card:
1. Each row names what would happen (**Add place**, **Move to another day**, **Add expense**, **Add booking**, and so on) and the values it would set. Untick **Include this change** on a row to leave it out.
2. **Compare on the map** switches between **Before** and **After**, and **Show on map** opens the planner on the change. Planned days come with a day preview (*Moves here*, *Comes off*), a check whether the day still **Fits the time**, and for longer plans an overview of **The days of this plan**.
3. **Apply** (or **Apply** *count*) makes the changes, with your own permissions, exactly as if you had made them by hand. **Discard** drops them.
While a card is waiting, the chat asks you to **Apply or discard the changes above first** before it goes on. A suggestion nobody decides on expires after 24 hours and then reads **No longer available**.
**Undo** on an applied card takes the change back again, and **Undo all** takes back the whole card. Undo is offered for 15 minutes. When someone changed the same thing in the meantime, TREK does not overwrite their work: the row reads *Changed in the meantime. Please adjust it by hand.*
On a trip you can only view, the assistant still answers questions, but it says so and suggests no changes.
## What the answers show
Besides text, an answer can carry cards that work like the rest of TREK:
- **Places found**: the places the assistant found, with **Add to trip**, **On map**, opening hours (**Open now** or **Closed**) and the distance from the previous stop. A place already planned reads **Already in your trip**. On a tour, **Add to tour** puts one in as a stop.
- **Weather** for the days the question is about, with the chance of rain.
- Cards for days, bookings, costs, packing items, to-dos, tours, journal entries and photo book pages, each with a way to open the item in TREK.
- With **Map follows the assistant** on, the trip map moves to where the assistant searches and suggests places.
- With **Estimate costs** on, a suggested restaurant or ticket comes with an estimated expense for the budget, as a card you confirm.
Both switches are in **Settings → Integrations** under the AI connection, see [AI-Connections](AI-Connections#your-settings).
## Files and bookings
**Attach a booking** under the chat field, or a file dropped on the chat, hands the assistant a booking confirmation, an email, a PDF, an image or a wallet pass of up to 10 MB.
- TREK's own booking reader looks at it first, the same one [AI-Booking-Import](AI-Booking-Import) uses. The bookings it finds come back as cards to add.
- When it finds none, the chat says why and offers what to do next: **Keep it in Files**, **Create a booking from it**, **Attach it to a booking or an expense** or **What is in the file?**
- The file's contents go to the AI provider only after you confirm a card, **Let the assistant read the file**, which names where it is sent. Keeping the file in the trip's Files is a card too.
- Route files (GPX and similar) can become a tour, see [Tours](Tours).
A file attached in the chat is kept for seven days so the conversation can come back to it, then it is deleted. A file you kept in Files stays there like any upload.
## Sharing an answer
**Share in the trip chat** posts an answer to the trip's [Collab chat](Collab-Chat), marked as coming from the assistant. The preview shows what everyone on the trip will see, and **Add the changes you applied** lists what you applied. This needs the trip chat to be switched on.
## The home chat
Outside a trip the assistant is about **Your travels**: *Which trip is next, and what is still open?*, *Compare my upcoming trips*, *How many countries have I visited?* or *How many vacation days do I have left this year?* It reads your trips but changes none of them. When a question belongs to one trip, it offers **Continue in a trip chat**, and **Chat about one trip** in the head opens a trip's own chat directly. **Back to all trips** returns.
## What it can and cannot do
The assistant works with your rights and no more. It can do what you could do through [MCP](MCP-Overview) yourself, with a few exceptions it never gets: it cannot delete a trip, create share or invite links, read the contents of your files without your consent, or use plugin tools.
- One answer may take up to 30 model steps. A very large request stops there and asks *That was a lot at once. Shall I continue?*, and **Continue** goes on.
- The administrator can limit how many messages each person sends per day while the instance pays for the model. Your settings then show how many of today's messages you have used, and at the limit the chat says *That's it for today. See you tomorrow.*
- The assistant needs a connection. Offline it says so and waits.
## Privacy
The first time you chat, a banner names the provider your messages go to. **What gets shared?** spells it out: your messages and the trip details the assistant reads, like places, days and bookings. Not your password, your files or your other trips. The provider handles this under its own privacy terms.
Chats are deleted after the number of days the administrator chose (90 by default); the chat list says how long they are kept. Deleting a chat removes it at once.
## The assistant and other AI features
| Feature | What it is |
|---|---|
| AI Assistant (this page) | A chat inside TREK that suggests changes you confirm |
| [AI-Booking-Import](AI-Booking-Import) | Reads booking files that TREK's own reader cannot. It can share the assistant's connection |
| [MCP](MCP-Overview) | Lets an AI app outside TREK, such as Claude or Cursor, work with your trips |
## See also
- [AI-Connections](AI-Connections)
- [TREK-Studio](TREK-Studio#the-book-assistant)
- [Mobile-App](Mobile-App)
- [Admin-Addons](Admin-Addons)
- [MCP-Overview](MCP-Overview)
wiki/AI-Connections.md
+107
View File
@@ -0,0 +1,107 @@
# AI Connections
TREK's AI features run on a language model from a provider you choose. The **AI connection** is that link: which provider answers, with which account or key, and which model. The [AI Assistant](AI-Assistant) runs on it, and [AI Parsing](AI-Booking-Import) can read your imported bookings with the same connection, so one setup serves both.
[MCP](MCP-Overview) works the other way round and needs no AI connection in TREK: there an AI app outside TREK brings its own model and talks to TREK.
## Providers
| Provider | How you connect | Notes |
|---|---|---|
| **Anthropic** | API key | *Claude Max and Team include API credits.* |
| **OpenAI** | API key | Create a key in your OpenAI dashboard. |
| **Gemini** | API key | AI Studio has a free tier with limits per minute and per day, on which Google may use what you send to improve its products. With billing turned on the limits are higher and that does not apply. |
| **OpenRouter** | API key, or **Connect OpenRouter** | Signing in with OpenRouter hands TREK a key, no copying needed. Offered only when TREK runs on an `https://` address, because OpenRouter only sends the browser back to one. |
| **ChatGPT** | **Sign in with ChatGPT** | Uses your ChatGPT plan, no key needed. Marked **Beta**: an API key is the official way. |
| **Own server** | Server address, optional API key, model | Any OpenAI compatible server, for example Ollama. Only an administrator can set one up, for everyone. |
**Paste an API key** recognises the provider from the key itself and says **Detected:** with its name. When a key does not give its provider away, TREK asks **Which provider is this key from?** The key is tested as soon as you connect. **Get a key** opens the provider's page for making one.
**Sign in with ChatGPT** works in two steps, because ChatGPT does not send you back to TREK by itself:
1. **Open ChatGPT sign-in** opens ChatGPT in a new tab. Sign in there.
2. Your browser then shows an error page. That is expected. Copy the address at the top, which starts with `127.0.0.1`, come back and use **Paste address**.
If it takes too long, TREK asks you to sign in again. A ChatGPT account other than the one already connected is refused until you remove the connection first.
### Choosing a model
Once connected, **Model** lists what the provider offers. *Only models that can use tools are listed*, because the assistant works through TREK's tools. **Recommended** marks a good default and **Free** a model without charge. A new connection starts on a model TREK picks; change it whenever you like.
## Your settings
Your connection lives in **Settings → Integrations**, in the **AI assistant** section (named **AI parsing** when only AI Parsing is switched on). What the section offers depends on how the administrator set things up:
| The administrator chose | What you see |
|---|---|
| **I pay for everyone** | **Provided by your admin**, and nothing to set up. *Your admin sets this up.* |
| **I pay, own allowed** | **Provided by your admin**, plus **Connect your own provider** if you prefer your own account. Your own connection then takes over for you. |
| **Everyone uses their own account** | *What would you like to chat with?* with **Sign in with ChatGPT** and **Paste an API key**. |
A connected section shows **Connected to** *the provider*, its status and the model:
| Status | Meaning |
|---|---|
| **Connected** | Working. |
| **Sign-in expired** | A ChatGPT sign-in ran out. **Sign in again** renews it. |
| **Signed out** | You signed out; the connection counts as none. |
| **Not reachable** | The provider did not answer or refused the key. **Replace key** fixes a key that stopped working. |
When your own connection breaks, TREK does not quietly switch you to the administrator's: you see why yours does not work instead.
**Disconnect** (or **Sign out** for ChatGPT) removes your connection. Your chats stay. **Open assistant** opens the chat straight from here.
Two switches for the assistant sit in the same section:
- **Map follows the assistant**: the trip map moves to where the assistant searches and suggests places.
- **Estimate costs**: with a restaurant or a ticket, the assistant suggests an estimated expense for the budget, as a card you confirm.
While the administrator pays, the section also shows how many of today's messages you have used.
If you saved your own AI parsing model before the shared connection existed, that older section still shows below; see [AI-Booking-Import](AI-Booking-Import).
## For administrators
> **Admin:** In **Admin → Addons**, the **AI Assistant**, **AI Parsing** and **MCP** addons share one **AI** tile: *One connection for the assistant and booking import. MCP lets other AI apps use TREK.* Switch the addons on there, then press **Set up AI**. See [Admin-Addons](Admin-Addons).
**Set up AI** opens one dialog with a tab per part. A tab shows only while its addon is on, and every change is saved at once.
### Connection
**Who pays** decides whose connection the assistant runs on:
| Choice | Effect |
|---|---|
| **I pay for everyone** | Everyone uses the connection below and cannot add their own. |
| **I pay, own allowed** (the default) | Everyone uses the connection below unless they connect their own. |
| **Everyone uses their own account** | Everyone connects their own provider. Nothing is charged to you. |
While you pay, **Connection for everyone** holds the instance's connection: an API key, a ChatGPT sign-in, or an **Own server**. An own server takes a **Server address**, an optional API key and a model; when AI Parsing already talks to a local model, the form is prefilled from it (*Taken over from AI Parsing.*). **Change** replaces the connection and **Remove connection** deletes it.
> Signing in with your own ChatGPT plan for everyone shares that plan with everyone on the server: their chats count against your plan. Check that your plan and OpenAI's terms allow this.
TREK reaches an own server through the guard meant for services on your own network, so a model server on the same machine or your LAN works without `ALLOW_INTERNAL_NETWORK`. The cloud providers go through the strict guard. See [Internal-Network-Access](Internal-Network-Access).
### AI Assistant
- **Messages per person per day**: the daily limit, 50 by default. *Only counts while you pay*, so it never limits someone on their own connection. The day ends at midnight UTC.
- **Keep chats**: how long conversations are kept, 30 days, 90 days (the default), 365 days or **Forever**. Older chats are deleted every night.
- **Web search**: on by default. The assistant may look things up on the web through the search of the provider it talks to. Works with ChatGPT, Anthropic and OpenRouter; the searches go only to that provider.
### AI Parsing
**Reads bookings with** chooses the model that reads imported booking files: the shared connection (marked **Shared**), or an **Own connection** used instead of it, such as a local Ollama. Under **Everyone uses their own account**, each person reads with their own connection, set up in their settings. For a local model the tab lists what is **Installed on the server**, with **Refresh**, and **Pull a recommended model**. Details are on [AI-Booking-Import](AI-Booking-Import).
### Where secrets are kept
API keys and ChatGPT sign-in tokens are stored encrypted with the server's encryption key and are never shown again. Rotating that key re-encrypts them; see [Encryption-Key-Rotation](Encryption-Key-Rotation). Saving and removing connections and changing the AI settings is recorded in the [Audit-Log](Audit-Log).
The demo account cannot connect a provider of its own.
## See also
- [AI-Assistant](AI-Assistant)
- [AI-Booking-Import](AI-Booking-Import)
- [MCP-Overview](MCP-Overview)
- [Admin-Addons](Admin-Addons)
- [User-Settings](User-Settings)
wiki/TREK-Studio.md
+188
View File
@@ -0,0 +1,188 @@
# TREK Studio
TREK Studio turns a [journey](Journey-Journal) into a photo book you can print. It lays the journey's entries, photos and route out as pages, lets you change every one of them, and makes a print ready PDF at the end. A book belongs to its journey: the photos, words, places and figures it shows come from there, and several people can design it at the same time.
## Opening Studio
Open a journey and press **Studio** in its header. The designer opens over the journey at `/journey/:id/studio`, so the journey stays open underneath and **Back to the journey** returns you straight to it.
Studio needs room to work. It is desktop only and needs a window at least 1024 px wide. In a narrower window, or on a tablet, it shows *Studio needs a bigger screen* with a way back, and on a phone it is not offered at all. Making the PDF is desktop only as well.
Who may do what follows the journey exactly: anyone who may read the journey may open its book, and only those who may edit the journey may change or delete it. A reader sees **Read-only, not saved** in the header.
## The screen
| Area | What it holds |
|---|---|
| Header | **Page format**, **Auto layout**, undo and redo, paste, the **Assistant**, help, and **Export** |
| Left rail | The sections that put things on a page: **Pages**, **Content**, **Layouts**, **Elements**, **Travel**, and set apart below them **Theme** and **Layers** |
| Workbench | The spread you are working on, with zoom (**Zoom in**, **Zoom out**, **Fit to view**) and **Book view** |
| Properties | Everything about what is selected, on the right |
The rail and the tabs inside its panels answer to the arrow keys.
## Page format and the shape of the book
**Page format** offers **Square 21 × 21 cm** (the default), **Square 30 × 30 cm**, **A4 landscape**, **A4 portrait**, **A5 landscape** and **Custom size** in millimetres. Every page has 3 mm of bleed (what is cut off at the edge) and a 5 mm safe area, both of which the header can show as guides.
A book follows the shape of a bound one:
1. the **Cover**, whose inside stays blank,
2. a single first page on the right, page 1, where a title page or a dedication goes,
3. the double pages (spreads) in between,
4. a single last page on the left,
5. the **Back cover**, whose inside stays blank too.
The covers and the single first and last pages stay where they are; new spreads always go between them. **Page numbers** can be switched on with nothing selected: outer, inner or centred, with where they start and their margin. They count from the first page, and the number on screen is the number that prints.
## Pages
The **Pages** panel lists the book. **Add spread** adds one after the last, and each spread offers **Insert a spread after this one**, **Duplicate spread**, **Move earlier**, **Move later** and **Delete spread**. **Book view**, beside the zoom buttons, draws the fold down the middle of each spread on the workbench and in the page list; it is on by default.
### Auto layout
**Auto layout** in the header builds pages out of the journey for you:
- **This spread** lays the spread on screen out again from the journal entry it came from, on another design. It is only offered on a spread that auto layout made.
- **The whole book** replaces every page, keeping your title and page setup.
Both are ordinary undo steps: press one, look at the result, and undo it if you liked the old one better.
An element that auto layout tied to a journal entry follows that entry, so a corrected caption in the journal reaches the book. Editing the element in Studio breaks the link (*Follows the journal entry. Editing it here breaks that link.*).
## Content
**Content** holds the journey's own **Photos** and **Entries**. **Search photos and entries** finds one, and **Filter photos** narrows the photos to **All photos**, **Not in an entry**, **Just uploaded** or **This page**. Drag a photo onto the page or onto an empty frame, or use **Add to this page**. An entry adds its title, story, place or **Pros & Cons** as blocks of their own.
- **Upload photos** adds pictures from your computer. They go into the open entry, or into the journey's gallery when none is open. Videos are left out: a book holds pictures.
- With Immich or Synology Photos connected, **From Immich** or **From Synology Photos** picks photos from your library the way the journey gallery does. See [Photo-Providers](Photo-Providers).
## Layouts
**Layouts** arranges a whole page at once, with that page's own photos and words.
**Designed pages** come first: pages laid out by a designer, 48 for the cover and the other single pages and 60 double spreads, in twelve styles (**Spine band**, **Poster**, **Cut-out**, **Postcard**, **Grid and badge**, **Minimal**, **Stamps**, **Riso**, **Editorial**, **Vintage poster**, **Night film** and **Field notes**). Each card shows the page you are on as the click would lay it, with its own photos and words and in the book's theme. The **Style** chips narrow the set to one look. What a design has no room for stays with the page.
Below come **My layouts** and the **Built in** ones: thirteen spread layouts (**Hero and story**, **Four up**, **Strip and text**, **Mosaic** and more) and five for the cover and back.
**Save this page as a layout** keeps the arrangement of a page without its photos, for every editor of this book. Applying it lays another page out the same way and keeps that page's photos and words. A book keeps up to 24 layouts.
## Elements
**Elements** adds things to a page, in six tabs:
| Tab | What it adds |
|---|---|
| Text styles | Ready made titles, badges and stamps, chapter numbers, quotes, captions and coordinates, set in your book's title and sized to fit. A style arrives selected as one set; click a single part to change its words. |
| Shapes | Basic shapes, polygons, stars, arrows, speech bubbles, travel shapes, decoration and banners |
| Lines | Straight and drawn lines in several strokes |
| Frames | **Empty frame**, frame styles (**Plain**, **Polaroid**, **White border**, **Drop shadow**, **Film**, **Taped**), frame shapes and **Grids** of empty frames |
| Icons | A searchable icon library, **For travel** or **All icons** |
| Stickers | A sticker library in twelve themes, from travel things and landmarks to doodles and ornaments, with **Recently used**. Click one to place it in the middle of the page, or drag it where it should go. |
An empty frame marks where a picture goes; drop a photo on it from **Content**.
## Travel
**Travel** builds figures out of the journey itself. When the journey changed since they were taken, **Update from journey** refreshes them.
- **Maps**: a **Route map** of the journey, either **Whole journey** or **One trip at a time**, in the styles **Minimal**, **Outline**, **Paper** or **Dark**. The source can be outlines, relief, satellite or map tiles. **Roads** asks a routing service for the way each leg was driven and keeps it in the book, so it prints the same line offline. A map can sit **In a box** or be **Cut to shape** of a country, and shows how sharp it prints at its size.
- **Figures**: distance, days, steps, photos, countries, places and the furthest point, as single figures or together, in looks from **Classic** and **Ticket** to **Odometer**, **Road sign** and **Sketch**.
- **Countries**: the countries of the journey as outlines, lists or flags, in looks such as **Visa**, **Stamp**, **Postcard** or **Luggage label**.
- **Marks**: **Date**, **Day counter**, **Coordinates**, **Flag** and **Distance**.
- **Stops**: every stop counts toward the route, the distance and the countries. Switch one off to leave it out, your home airport for instance.
## Theme
**Theme** sets the look of the whole book. Pick one of seventeen themes, such as **Poster pop**, **Postcard**, **Riviera**, **Nordic**, **Alpine**, **Riso print**, **Magazine**, **Midnight** or **Field notes**, then **Apply to the book** or **Apply to this page**. Colours and type that follow the theme change with it; everything else stays as it is.
- **Palette**: the paper, ink, muted and accent colours. **Colours from the photos** takes them from your pictures.
- **Typefaces**: the display, heading, body and script faces.
- **Motifs**: the sticker themes that suit the look.
- **Decoration**: **None**, **Light** or **Rich**.
- **Also restyle what isn't linked yet** first links backgrounds, text and shapes to the theme. White words over photos stay as they are.
A colour that follows the theme reads **Theme colour** in the properties; **Stop following the theme** frees it. **Back to the original theme** undoes a theme change.
## Properties
**Properties** on the right edits whatever is selected, in the same order for every kind: what the element is or says, then its position and size, then its look, then its effects, and last **Arrange**. The groups you use are open, and a group opens by itself on an element that already uses it. With nothing selected the panel shows the page background, the book's theme and the page numbers.
### Photos
- **Crop**: **Fill** or **Fit**, zoom, **Mirror**, and a focal point you drag to choose what stays in frame.
- **Look**: the filters **Original**, **Black & white**, **Warm**, **Cool**, **Faded** and **Punchy**, and **Adjust** for brightness, contrast, saturation and warmth.
- **Border and shadow**, a **Cutout edge**, a corner radius, and **Cut to shape** to put the photo in a shape.
- **Fill page** or **Fill spread** stretches the picture over the whole page, bleed included, and sends it behind everything else.
- Studio says how sharp a photo prints (*Prints at about* so many dpi) and warns when it would look soft.
### Text
- Typeface, weight, size, line height, tracking, alignment (including **Justified**) and colour. **Change typeface** searches the faces by kind: sans serif, serif, elegant display, condensed and poster, heavy and retro, script and handwriting, monospace. **Used in this book** lists the faces you already have.
- **Case and placement**: **As typed**, **Capitals**, **Lower case** or **Small caps**; the text's place in its frame; and **Shrink to fit**, which treats the size you set as the largest.
- **Effects**: **Hard shadow**, **Marker band**, **Curve** (**Arc**, **Circle** or **Bend**), **Hollow** letters, and **Photo inside the letters**, where a photo shows through the type.
### Shapes, lines and backgrounds
A shape, a sticker's colours and the page background take a fill: **Solid**, **Gradient** (linear or radial, with colour stops) or **Pattern**. Shapes also take an outline (**Solid**, **Dashed** or **Dotted**), opacity and rotation.
### Arrange
**Arrange** aligns and stacks: **Bring to front**, **Bring forward**, **Send backward**, **Send to back**, **Lock**, **Duplicate**, **Delete**, grouping, **Copy style** and **Paste style**, and **Show in Layers**. Several selected elements can be aligned to each other, to the page or to the safe area, and spaced evenly.
## Layers
**Layers** lists the page front to back. Drag a row to restack it, double click a name to rename it, **Hide** or **Show** an element, and **Group** or **Ungroup** several. Double click an element on the page to work inside its group.
## Keyboard shortcuts
| Keys | Action |
|---|---|
| Ctrl+Z, Ctrl+Shift+Z | Undo, redo |
| Ctrl+C, Ctrl+V | Copy and paste elements, onto any page |
| Ctrl+D | Duplicate |
| Ctrl+A | Select everything on the page |
| Ctrl+G, Ctrl+Shift+G | Group, ungroup |
| Ctrl+Alt+C, Ctrl+Alt+V | Copy style, paste style |
| Ctrl+], Ctrl+[ | Bring forward, send backward; with Shift to the front or the back |
| Arrow keys | Move by 1 mm, by 10 mm with Shift |
| Delete or Backspace | Remove what is selected and not locked |
| Escape | Inside a group, back to the whole group |
On a Mac, Ctrl is Cmd. While you type in a field or a text on the page, the keys are the text's.
## Saving and designing together
Studio saves as you go. The header shows **Saving**, **Saved**, or **Not saved** with **Try again**.
Several people can design the same book at once. Everyone sees the others' pointers with their names, and who is **here**. A save is passed to the others live. When a save lands on a version somebody else changed in the meantime, Studio does not overwrite their work: *Someone else saved this book* offers **Take theirs** or **Keep mine**.
**Download this spread** saves the design of the spread you are on as a file, without the photographs, and **Import** adds such a spread to another book.
## Export and printing
**Export** opens the print settings:
- **Layout**: **Single pages** (one leaf per sheet, in reading order, what a printer wants) or **Spreads** (two pages at a time, the way the book opens, for reading).
- **Finishing**: **Crop marks** adds the bleed on every edge and marks where to cut.
The note under it says how many sheets at what size you get. **Print view** opens the book in your browser's print view, and **Save as PDF** turns it into a PDF there. The button waits (**Preparing**) until every photo and typeface has loaded, so nothing prints as an empty box or in the wrong font.
## The book assistant
With the [AI Assistant](AI-Assistant) set up, **Assistant** in the Studio header opens the **Book assistant** beside the page (*Design the book together with the assistant*). Ask it *What should the book look like?* and it can:
- start the book, add, change, move, duplicate and delete pages, change the cover, the page format and the theme, and save a page as a layout,
- propose a whole book design in a style such as **Classic design**, **Minimal design**, **Editorial design**, **Journal design**, **Bold design** or **Scrapbook design**, with its colours and typefaces. You choose per page which pages take the new design,
- check a page and list what to fix, such as text running past its frame, something in the fold or past the edge, an empty photo frame, a photo that may print blurry, text that is hard to read, too many typefaces or the same layout again and again.
Every change arrives as a card you apply or discard, with **Show this page**, and can be undone, the same as in a trip. Someone who can only read the book can ask questions, but the assistant changes nothing for them.
**Pictures of your pages.** The assistant always reads a page as a description. To let it look at the page itself, Studio asks once: *The assistant can look at the page you are working on. Only that page goes to the provider, as a picture showing just the photos you added yourself.* **Show it pages** allows it for that connection, **Not now** keeps to descriptions. Photos added by other people are drawn as empty frames, and nothing of the picture is stored.
## See also
- [Journey-Journal](Journey-Journal)
- [AI-Assistant](AI-Assistant)
- [Photo-Providers](Photo-Providers)
- [Help-Center](Help-Center)