# Aperture 1.0.0 Aperture 1.0.0 brings the Encore workspace, the mobile app layout, Play Iris branding, and the recommendation and performance work from the development series to the stable channel. The previous stable version was 0.7.10. ## At a glance | Area | What shipped | | --- | --- | | Encore | A persistent media consultant with conversation history, watch plans, editable memory, collections, and opt-in recurring curation. | | Mobile | A floating navigation dock, keyboard-aware composer, and standalone Home Screen launch into Encore. | | Welcome tour | Four quick steps with examples and links, plus a dismissal saved to your account. | | Play Iris | A new Aperture mark in the app, API documentation, fallback artwork, and Home Screen icons. | | Recommendations | Freshness controls, optional Emby publishing modes, and Tonight picks with temporary snoozes. | | Discovery and appearance | Faster Discovery and People reads, progressive upcoming episodes, and the optional Studio light and dark theme. | | Administration | Scoped MCP connections, tighter runtime API validation, and a media import job that runs independently of AI generation. | ## Summary for users - The redesigned welcome tour shows how to browse your library, improve recommendations with ratings, ask Encore for ideas, and change your appearance. Check **Don’t show this tour again until it changes** and close or finish the tour to save the dismissal across devices. The redesign counts as a new tour version. To revisit it, choose **How It Works** in the account menu or on the **You** tab. - The mobile layout refresh brings results closer to the top of Discover, Library, history, and Top Picks. The shorter header and dock leave more room for content. Title details put the poster beside the title, requests fit the phone width, and setup shows the current step with a progress bar. - Encore can consult your accessible library and viewing history, find releases, and help assemble a watch plan. Manage its saved memory, plans, collections, and connections from the workspace. Web search and recurring curation are opt-in. [Encore documentation](https://github.com/dgruhin-hrizn/aperture/blob/v1.0.0/docs/encore-rebuild.md) - Open Aperture from your Home Screen to launch Encore in standalone mode. The mobile dock keeps Discover, Library, Encore, Watching, and You within reach. Play Iris is used for the installed icon. [Mobile app documentation](https://github.com/dgruhin-hrizn/aperture/blob/v1.0.0/docs/mobile-app.md) - Choose Studio under **Avatar → Appearance** for a light, dark, or device-following theme. Discovery rows and People portraits load progressively, and Emby users can snooze a Tonight pick for 12 hours. [Appearance settings](https://github.com/dgruhin-hrizn/aperture/blob/v1.0.0/docs/features/user-settings/appearance.md) ## Summary for admins - Configure recommendation outputs independently for movies and TV. Emby supports named TV groups, private native playlists where supported, and pinning Aperture-managed playlists to Home. **Import Media Server** syncs catalog and history without generating AI recommendations. [Output configuration](https://github.com/dgruhin-hrizn/aperture/blob/v1.0.0/docs/admin/output-format.md) - Create individually scoped, revocable MCP connections from Encore. Playlist actions require approval, and recurring curation runs only after explicit opt-in. [MCP setup and permissions](https://github.com/dgruhin-hrizn/aperture/blob/v1.0.0/docs/encore-mcp.md) ## Database migrations Upgrades from 0.7.10 apply migrations **0115–0123**. These add recommendation suggestion history, Emby groups and managed playlists, Tonight snoozes, and storage for Encore messages, scoped connections, memory, plans, actions, and recurring curation. The suggestion-history migration backfills retained completed runs, and the Encore message migration assigns stable keys to existing messages. The supplied production Compose files apply pending migrations at startup and continue to use PostgreSQL 16 with pgvector. Back up the database and uploaded artwork before updating. ## API and operator notes - `GET /health`, OpenAPI, and the web app report **1.0.0**. - The welcome tour saves its dismissed version in existing account preferences. The tour refresh requires no additional database migration. - The scoped Encore MCP endpoint uses Streamable HTTP at `/mcp`. The release also includes the standalone `aperture-mcp.mjs` bridge and its SHA-256 checksum for local stdio clients. [MCP connection instructions](https://github.com/dgruhin-hrizn/aperture/blob/v1.0.0/docs/encore-mcp.md) ## Update instructions The stable image is `ghcr.io/dgruhin-hrizn/aperture:latest`. Pin `ghcr.io/dgruhin-hrizn/aperture:1.0.0` to keep this version. 1. Back up PostgreSQL and uploaded artwork. Keep the existing database and mounts. 2. From the directory containing your production Compose file, pull and restart Aperture. ```bash docker compose pull docker compose up -d ``` 3. Confirm the startup log shows successful migrations and `/health` reports **1.0.0**. Sign in and check Encore and your configured recommendation outputs. ## Changelog since 0.7.10 - Rebuilt Encore's conversation runtime and shared media tools with scoped MCP connections. [#120](https://github.com/dgruhin-hrizn/aperture/pull/120) · [#122](https://github.com/dgruhin-hrizn/aperture/pull/122) - Added Encore memory, watch plans, approved Emby actions, and opt-in recurring curation. [#124](https://github.com/dgruhin-hrizn/aperture/pull/124) · [#125](https://github.com/dgruhin-hrizn/aperture/pull/125) - Added mobile navigation and improved Encore search, release dates, and mobile result cards. [#127](https://github.com/dgruhin-hrizn/aperture/pull/127) · [#133](https://github.com/dgruhin-hrizn/aperture/pull/133) · [#137](https://github.com/dgruhin-hrizn/aperture/pull/137) - Improved Studio appearance, Discovery and People loading, upcoming episodes, and LAN and reverse-proxy access. [#113](https://github.com/dgruhin-hrizn/aperture/pull/113) · [#118](https://github.com/dgruhin-hrizn/aperture/pull/118) · [#119](https://github.com/dgruhin-hrizn/aperture/pull/119) · [#121](https://github.com/dgruhin-hrizn/aperture/pull/121) - Enforced runtime API contracts across Aperture. [#132](https://github.com/dgruhin-hrizn/aperture/pull/132) - Shipped Play Iris throughout the app and Home Screen experience. - Redesigned the welcome tour and saved dismissal per account and tour version. [Full comparison with 0.7.10](https://github.com/dgruhin-hrizn/aperture/compare/v0.7.10...v1.0.0)