# Ember - Discover Movies by Feeling
> AI-powered movie discovery platform that recommends films based on emotional categories and mood, not just genres. Find your next favorite movie by how you want to feel.

## Core Features
- [Emotion-Based Discovery](https://ember.film): Browse 50+ emotional categories like "Feel Good", "Mind-Bending", "Cozy Night In"
- [AI Recommendations](https://ember.film/search): Semantic search powered by vector embeddings finds movies that match your mood
- [Category Pages](https://ember.film/c/feel-good-933da79d): Curated collections based on emotional themes and viewing experiences
- [Movie Pages](https://ember.film/movie/27205): One page per film — synopsis, cast, director, runtime, genres, and the categories it belongs to
- [Ember for Stremio](https://ember.film/stremio): Install Ember as a Stremio addon to get mood-based catalogs inside Stremio

## Site Structure
- `/` — home: spotlight picks, new releases, popular, and an index of every category
- `/c/{slug}` — one page per emotional category, with the full list of films in it
- `/movie/{id}` — one page per film (canonical, citable URL for a specific movie)
- `/stremio` — the Stremio addon landing page
- `/search?q=...` — semantic search (live results; not indexed)

## How It Works
- **Emotional Categories**: Movies are classified by the feelings they evoke, not just traditional genres
- **Vector Embeddings**: AI understands the emotional essence of each film for precise matching
- **Personalized Results**: Recommendations adapt to your preferences and viewing history

## Key Differentiators
- **Beyond Genres**: Traditional genres miss nuance - "action" doesn't tell you if a film is heartwarming or intense
- **AI-Powered Matching**: Semantic understanding of movie themes, tone, and emotional impact
- **Rich Metadata**: Detailed information including watch providers, streaming availability, and ratings

## Integrations
- Watch provider information (streaming platforms where movies are available)
- Plex media server integration
- Radarr integration for automated downloads
- Multi-language support (8 languages)

## Content Focus
- Movies only (no TV shows)
- Comprehensive TMDB metadata
- AI-generated emotional descriptions

## Languages
English, Czech, German, French, Italian, Afrikaans, Xhosa, Zulu

## For AI Agents & LLMs (plain-text + markdown endpoints)
These endpoints return clean, token-efficient text/markdown intended for machine reading — no HTML, no JS required.

- Plain text homepage feed: https://ember.film/api/t
- Plain text category list: https://ember.film/api/t/categories
- Plain text category recommendations: https://ember.film/api/t/c/{slug}
  - Example: https://ember.film/api/t/c/feel-good-933da79d
- Plain text new releases for a category: https://ember.film/api/t/c/{slug}/new
- Plain text movie detail (with emotional PAD timeline): https://ember.film/api/t/movie/{id}
  - Example: https://ember.film/api/t/movie/27205
- Plain text semantic search: https://ember.film/api/t/search?q=YOUR_QUERY
  - Searches by meaning, not just title — descriptive queries work.
  - Example: https://ember.film/api/t/search?q=tense+but+hopeful
- Markdown category recommendations: https://ember.film/api/md/c/{slug}
  - Example: https://ember.film/api/md/c/feel-good-933da79d

Notes:
- Every endpoint above is explicitly allowed in robots.txt (both `/api/t` and `/api/t/`).
- `{slug}` accepts the canonical site slug (e.g. `feel-good-933da79d`) used in /c/ URLs.
- Responses are cacheable (Cache-Control: public, max-age=3600).
- Movie `{id}` is the Ember/TMDB movie id shown in the tables and in the site's movie detail view.

## Company
- Website: https://ember.film
- Focus: Emotion-based movie discovery