# Features, in detail
The deep dive the README keeps out of the title page: what a session can be tuned to do, and what each
setting changes.
## The deck
The deck is a page of your catalogue minus what you have already swiped. What it draws is a *mode*, set
in the Filter drawer's **Media** section, and every mode is one question:
Movies
Films only. This is the deck the app shipped with, and the default for a library that has no shows.
Shows
One card per series, with the commitment numbers on it: seasons, episodes, and whether the show is still
running. A series card can be swiped whole (*Whole shows*) or expanded into its episodes (*Single
episodes*), and either can be narrowed to *Continuing*, *Ended*, or *Only what I'm watching*.
Continue
The next unwatched episode of every show you are in the middle of — one card per show, the question
"what do we watch tonight" answered by where you actually left off.
Continue is only real when the server knows what you have watched. Jellyfin, Emby and Plex do; a TMDB
instance has no progress to read, so the mode says so instead of inventing a position. In a group session
the position shown is the host's, and it is labelled that way.
Episodes
The unwatched episodes of those same shows — bounded on purpose (five shows, a page of episodes each), so
a library with thousands of episodes cannot stall the deck.
Mixed
Select both movies and shows in the Media row: the deck interleaves the two rather than running one
catalogue out before the other. There is no "mixed" button because "both" is the whole idea.
### Starting a show
Opening a show answers the question a synopsis cannot: **where do I start**. The detail sheet carries the
commitment line (seasons · episodes · approximate hours), a start-here panel — *Where to start* for a show
you have not begun, *Where you are* for one you are inside, *The host's position* in a group session where
only the host's progress is knowable — then the seasons, and the episodes inside each one.
### Images and performance
Artwork is fetched through the app, never hot-linked: the request carries a width the media server actually
understands, capped by `MAX_IMAGE_WIDTH` (default `960`), a bounded number are in flight at once
(`IMAGE_CONCURRENCY`), and each has `IMAGE_TIMEOUT_MS` to answer. A timeout is a `504` the card retries —
never a broken image the browser then caches. Episode stills for cards behind the front one are requested
as thumbnails, not posters.
### Spoilers
An episode you have not played is a spoiler waiting to happen: the still, the episode title and the
synopsis each give the plot away. The deck hides all three behind a panel that names only the series and
the episode number, and leaves a **Reveal** on the card. The mask belongs to the card and is not
remembered — the next episode is masked again, and a played episode is never masked.
### When you both say yes
Two members liking the same title is a match, and a match takes the screen: who liked it, the poster (tap
it for the details sheet), and — for a show — where to start. **Continue** or Escape returns you to the
deck. If several matches land while you are reading one, they queue and arrive one after the other instead
of the second overwriting the first.
### Session Settings
When you create a session, customize it for your group:
Match Strategies
- **Two or More**: Any two people liking the same content creates a match
- Best for: Larger groups where majority rules
- Finding: Quick results, more options
- **Unanimous**: Everyone must like it for a match
- Best for: Smaller groups wanting guaranteed crowd-pleasers
- Finding: Fewer but higher-quality matches
Session Restrictions
- **Max Likes**: Limit right swipes per person
- Forces thoughtful, selective choices
- Prevents mindless approval
- **Max Nopes**: Limit left swipes per person
- Stops serial negativity
- Encourages open-mindedness
- **Max Matches**: Auto-stop when you have enough options
- Perfect for when you just need 3-4 solid picks
Guest Lending (Account Sharing)
**How it works:**
1. Host enables "Guest Lending" in settings
2. Guest joins session with just a name - no account needed
3. Messer Swipe uses the host's credentials to fetch content
4. Guest gets a unique ID, their swipes are tracked separately
5. Guests cannot access host account or modify settings
**Security note:** Host credentials are stored server-side and encrypted at rest using `AUTH_SECRET` while Guest Lending is enabled. See "Generating `AUTH_SECRET`" in Security & Privacy.
**Perfect for:** Movie nights with friends who don't have media servers
Admin Role
**Automatically Assigned:** First user to log in for each provider becomes that provider's admin.
**Manual Assignment:** Set `ADMIN_USERNAME` (global) or `[PROVIDER]_ADMIN_USERNAME` (e.g., `JELLYFIN_ADMIN_USERNAME`) environment variables.
**Admin Privileges:**
- Configure included media libraries for the provider
- Manage global provider settings
- Override session restrictions
- Access admin dashboard (only for providers with authentication)