Merge f9309364ed into d2df164b6a

README.md

@@ -1,56 +1,94 @@
-# Stremio - Freedom to Stream
+<div align="center">
+
+<img src="/assets/images/stremio_symbol.png" width="90" alt="Stremio logo">
+
+# Stremio Web
+
+**Freedom to Stream** — the official web UI of [Stremio](https://www.stremio.com), a modern media center that's a one-stop solution for your video entertainment.
 
 [![Build](https://github.com/Stremio/stremio-web/actions/workflows/build.yml/badge.svg)](https://github.com/Stremio/stremio-web/actions/workflows/build.yml)
 [![Github Page](https://img.shields.io/website?label=Page&logo=github&up_message=online&down_message=offline&url=https%3A%2F%2Fstremio.github.io%2Fstremio-web%2F)](https://stremio.github.io/stremio-web/development)
+[![Version](https://img.shields.io/github/package-json/v/Stremio/stremio-web/development?label=version&color=7b5bf5)](https://github.com/Stremio/stremio-web/releases)
+[![License](https://img.shields.io/github/license/Stremio/stremio-web?color=7b5bf5)](/LICENSE.md)
 
-Stremio is a modern media center that's a one-stop solution for your video entertainment. You discover, watch and organize video content from easy to install addons.
+**[🌐 Open the Web App](https://web.stremio.com)** · [Website](https://www.stremio.com) · [Report a bug](https://github.com/Stremio/stremio-web/issues/new/choose)
 
-## Build
+<img src="/assets/screenshots/board_wide.webp" alt="Stremio board" width="100%">
 
-### Prerequisites
+</div>
 
-* Node.js 22 or higher
-* [pnpm](https://pnpm.io/installation) 11 or higher
+## ✨ Features
 
-### Install dependencies
+- 🧩 **Addon-powered** — discover movies, series and channels from catalogs provided by [addons](https://web.stremio.com/#/addons)
+- 🔄 **Sync everywhere** — your library and Continue Watching follow your Stremio account across devices
+- 📺 **Casting** — play on the big screen via Chromecast
+- 💬 **Subtitles** — addon-provided or local, with customizable styling
+- ⌨️ **Keyboard-first player** — full playback control without touching the mouse
+- 🌍 **50+ languages** — community-translated via [stremio-translations](https://github.com/Stremio/stremio-translations)
+- 📱 **Installable** — runs as a standalone PWA
+
+## 📸 Screenshots
+
+| Discover | Meta Details |
+|:---:|:---:|
+| ![Discover](/assets/screenshots/discover.png) | ![Meta Details](/assets/screenshots/metadetails.png) |
+
+## 🛠 How it works
+
+The UI (this repo) is a React app, but the brains live in [stremio-core](https://github.com/Stremio/stremio-core) — Stremio's Rust engine compiled to WebAssembly and running in a Web Worker. The UI renders state, the core computes it. Playback goes through [stremio-video](https://github.com/Stremio/stremio-video), which picks the right player implementation for the environment.
+
+```mermaid
+flowchart LR
+    UI["React UI<br>(this repo)"] <--> Core["stremio-core<br>Rust → WASM, Web Worker"]
+    Core <--> API["Stremio API"]
+    Core <--> Addons["Addons"]
+    UI --> Video["stremio-video"]
+```
+
+## 🚀 Getting started
+
+You'll need [Node.js](https://nodejs.org) 22+ and [pnpm](https://pnpm.io/installation) 11+.
 
 ```bash
 pnpm install
-```
-
-### Start development server
-
-```bash
 pnpm start
 ```
 
-### Production build
+The dev server runs at `http://localhost:8080`.
 
-```bash
-pnpm run build
-```
+| Command | Description |
+|---|---|
+| `pnpm start` | Development server with hot reload |
+| `pnpm run start-prod` | Development server in production mode |
+| `pnpm run build` | Production build |
+| `pnpm test` | Run tests |
+| `pnpm run lint` | Lint the source |
+| `pnpm run scan-translations` | Check for missing translation keys |
 
-### Run with Docker
+### 🐳 Docker
 
 ```bash
 docker build -t stremio-web .
 docker run -p 8080:8080 stremio-web
 ```
 
-## Screenshots
+## 🤝 Contributing
 
-### Board
+Bug reports and pull requests are welcome — [`good first issue`](https://github.com/Stremio/stremio-web/labels/good%20first%20issue) is a great place to start. Want Stremio in your language? Contribute to [stremio-translations](https://github.com/Stremio/stremio-translations). Please read the [Code of Conduct](/CODE_OF_CONDUCT.md) first.
 
-![Board](/assets/screenshots/board.png)
+## 🧩 Ecosystem
 
-### Discover
+| Repository | What it is |
+|---|---|
+| [stremio-core](https://github.com/Stremio/stremio-core) | Rust engine: state, addon protocol, library, sync |
+| [stremio-video](https://github.com/Stremio/stremio-video) | Video player abstraction used by this UI |
+| [stremio-translations](https://github.com/Stremio/stremio-translations) | Community translations |
+| [stremio-addon-sdk](https://github.com/Stremio/stremio-addon-sdk) | Build your own addon in Node.js |
 
-![Discover](/assets/screenshots/discover.png)
+## 💬 Community
 
-### Meta Details
+[Website](https://www.stremio.com) · [Blog](https://blog.stremio.com) · [Reddit](https://www.reddit.com/r/Stremio) · [X](https://x.com/stremio) · [Help center](https://stremio.zendesk.com/hc/en-us)
 
-![Meta Details](/assets/screenshots/metadetails.png)
+## 📄 License
 
-## License
-
-Stremio is copyright 2017-2023 Smart code and available under GPLv2 license. See the [LICENSE](/LICENSE.md) file in the project for more information.
+Copyright © 2017-2026 Smart Code OOD. Released under the GPL-2.0 license — see [LICENSE](/LICENSE.md).