feat: add the OpenMedia downloader with API, web UI and docs

.gitignore

@@ -12,3 +12,10 @@ coverage/
 
 .DS_Store
 *.swp
+
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+apps/api/data/

CONTRIBUTING.md

@@ -1,9 +1,10 @@
 # Contributing
 
 ```bash
-mise install     # exact toolchain versions, from mise.lock
-lefthook install # formatting, secret scan, commit-message check
-mise run dev     # the compose stack
+mise install              # exact toolchain versions, from mise.lock
+lefthook install          # formatting, secret scan, commit-message check
+mise run //apps/api:dev   # the API
+mise run //apps/web:dev   # the web UI
 ```
 
 Before opening a pull request, run `mise run checklist`. It runs exactly what

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenMedia contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

NOTICE

@@ -0,0 +1,29 @@
+OpenMedia
+Copyright (c) 2026 OpenMedia contributors
+
+This product is a rebuild of ReClip (https://github.com/averygan/reclip),
+released under the MIT License:
+
+  MIT License
+  Copyright (c) 2026 ReClip authors
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+
+Third-party tools used at runtime: yt-dlp (Unlicense), FFmpeg (LGPL/GPL),
+Deno (MIT), Next.js (MIT), Flask (BSD-3-Clause), Phosphor Icons (MIT).

README.md

@@ -1,72 +1,128 @@
-# Openmedia
+<div align="center">
+  <img src="docs/public/logo.svg" alt="OpenMedia" width="96" />
+  <h1>OpenMedia</h1>
+  <p>Download videos from almost any website. Lightweight, self-hosted media downloader with a clean web UI.</p>
+  <p>
+    <a href="https://github.com/ttncode/openmedia/actions/workflows/ci.yml"><img src="https://github.com/ttncode/openmedia/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+    <a href="https://github.com/ttncode/openmedia/releases"><img src="https://img.shields.io/github/v/release/ttncode/openmedia?color=12939c" alt="Release" /></a>
+    <a href="https://github.com/ttncode/openmedia/stargazers"><img src="https://img.shields.io/github/stars/ttncode/openmedia?style=flat&color=12939c" alt="Stars" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-12939c" alt="MIT license" /></a>
+  </p>
+  <p>English | <a href="README.vi.md">Tiếng Việt</a></p>
+</div>
+
+## Features
+
+- Downloads from 1000+ sites through yt-dlp
+- MP4 and MKV video with a quality picker
+- MP3, M4A, Opus, FLAC and WAV audio
+- Trimming to a time range
+- Subtitles, embedded or as a separate SRT file
+- Cover art, metadata and chapters embedded in the file
+- A queue with live progress, cancel and a concurrency limit
+- Bulk links and playlists
+- Cookies for age-restricted or bot-checked videos
+- Optional password, rate limiting and private-network blocking
+- History, drag and drop, paste anywhere, keyboard shortcuts
+- Installable PWA with a share target
+- Light and dark themes with seven accent colors
+- English and Vietnamese
+
+<div align="center">
+  <img src="docs/public/screenshots/desktop-light.png" alt="OpenMedia desktop, light theme" width="70%" />
+  <img src="docs/public/screenshots/phone-dark.png" alt="OpenMedia on a phone, dark theme" width="20%" />
+</div>
+
+## Installation
+
+### Docker Compose
+
+Download `compose.yaml` and `example.env` from the
+[latest release](https://github.com/ttncode/openmedia/releases/latest), then
+copy the example settings:
 
-A monorepo generated by [scaffold](https://github.com/ttncode/scaffold). Every
-application in it implements the same task contract, so one command works the
-same way in every config root and CI never has to learn a language.
+```bash
+cp example.env .env
+```
 
-## Start here
+Edit `.env` and set `OPENMEDIA_PASSWORD` to a password of your own. The API
+refuses to start while it is still `changeme`; leave it empty only for a
+private local instance. Then start the stack:
 
 ```bash
-mise install     # the exact toolchain in mise.lock
-lefthook install # formatting, secret scan, commit-message check
-mise run dev     # the local services this project was generated against
+docker compose up -d
 ```
 
-`mise run dev` starts `compose.dev.yaml` — throwaway local copies of whichever
-database and cache this project selected, published on loopback only. A project
-generated with neither has nothing to start. See
-[docs/getting-started](docs/getting-started.md).
+Open `http://localhost:8080`.
 
-## The task contract
+### Installer script
 
-Every config root — each `apps/*`, `packages/*` and `docs` — answers the same
-nine tasks:
+```bash
+curl -fsSL https://github.com/ttncode/openmedia/releases/latest/download/install.sh | bash
+```
 
-| Task                  | What it does                               |
-| --------------------- | ------------------------------------------ |
-| `install`             | install dependencies from the lockfile     |
-| `format`/`format-fix` | report / repair formatting                 |
-| `lint`                | report lint failures                       |
-| `check`               | type-check                                 |
-| `test`                | run the tests                              |
-| `build`               | produce the build output                   |
-| `ci-unit`             | what CI runs on a pull request             |
-| `checklist`           | `ci-unit` plus `build` — the pre-push gate |
+The installer generates a random password and prints it with the address when
+it finishes.
 
-Run one for a single root with `mise run //apps/api:ci-unit`, or `mise run
-checklist` from the project root to run every root at once. That is exactly
-what CI runs, so a green checklist locally means a green pull request.
+### From source
 
-## Layout
+```bash
+git clone https://github.com/ttncode/openmedia.git
+cd openmedia
+mise install
+mise run //apps/api:dev
+mise run //apps/web:dev
+```
 
-| Path               | What lives there                                    |
-| ------------------ | --------------------------------------------------- |
-| `apps/`            | the applications, one config root each              |
-| `packages/`        | code shared between them                            |
-| `docs/`            | the documentation site, and `docs/decisions`        |
-| `compose.yaml`     | the stack a client runs, attached to every release  |
-| `compose.dev.yaml` | throwaway local services, started by `mise run dev` |
-| `install.sh`       | what an operator runs on the target host            |
+Open `http://localhost:3000`.
 
-## Releasing and installing
+## Documentation
 
-Commits are [Conventional Commits](https://www.conventionalcommits.org);
-Release Please turns `feat:` and `fix:` on `main` into a release, and the
-release publishes a container image and attaches `compose.yaml`, `example.env`
-and `install.sh` to it.
+- [Getting started](docs/getting-started.md)
+- [Usage](docs/usage.md)
+- [Configuration](docs/configuration.md)
+- [Deployment](docs/deployment.md)
+- [Troubleshooting](docs/troubleshooting.md)
+- [Security](docs/security.md)
 
-An operator installs a release with:
+## For Developers
 
-```bash
-curl -fsSL https://github.com/ttncode/openmedia/releases/latest/download/install.sh | bash
-```
+Every config root (`apps/api`, `apps/web`, `docs`) answers the same task
+contract: `install`, `format`/`format-fix`, `lint`, `check`, `test`, `build`,
+`ci-unit`, `checklist`. Run one root's checks with `mise run
+//apps/api:ci-unit`, or `mise run checklist` from the project root to run
+every root, which is exactly what CI runs.
+
+| Path       | What lives there                  |
+| ---------- | --------------------------------- |
+| `apps/api` | Flask backend, yt-dlp integration |
+| `apps/web` | Next.js web UI                    |
+| `docs`     | This documentation site           |
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the branch and commit conventions.
+
+## Get Help
+
+- [Troubleshooting guide](docs/troubleshooting.md)
+- [Report a problem](https://github.com/ttncode/openmedia/issues)
+- [Security policy](SECURITY.md)
+
+## Acknowledgments
+
+- [ReClip](https://github.com/averygan/reclip), the project OpenMedia is built on
+- [yt-dlp](https://github.com/yt-dlp/yt-dlp)
+- [FFmpeg](https://ffmpeg.org)
+- [Deno](https://deno.com)
+- [Next.js](https://nextjs.org)
+- [Flask](https://flask.palletsprojects.com)
+- [Phosphor Icons](https://phosphoricons.com)
+- The [scaffold](https://github.com/ttncode/scaffold) toolbox this project was generated with
+
+## Disclaimer
 
-A private project needs a `GITHUB_TOKEN` carrying `repo` and `read:packages` —
-see [docs/deployment](docs/deployment.md) for why one scope is not enough.
+OpenMedia is for personal use. Respect copyright law and the terms of service
+of the sites you download from.
 
-## Contributing
+## License
 
-[CONTRIBUTING.md](CONTRIBUTING.md) covers the branch and commit conventions.
-Architecture decisions live in [docs/decisions](docs/decisions); read the
-relevant one before changing behaviour it covers, and add one when you make a
-decision the next reader would otherwise have to reconstruct.
+MIT, see [LICENSE](LICENSE) and [NOTICE](NOTICE).

README.vi.md

@@ -0,0 +1,128 @@
+<div align="center">
+  <img src="docs/public/logo.svg" alt="OpenMedia" width="96" />
+  <h1>OpenMedia</h1>
+  <p>Tải video từ hầu hết mọi trang web. Công cụ tải media gọn nhẹ, tự lưu trữ, với giao diện web rõ ràng.</p>
+  <p>
+    <a href="https://github.com/ttncode/openmedia/actions/workflows/ci.yml"><img src="https://github.com/ttncode/openmedia/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+    <a href="https://github.com/ttncode/openmedia/releases"><img src="https://img.shields.io/github/v/release/ttncode/openmedia?color=12939c" alt="Release" /></a>
+    <a href="https://github.com/ttncode/openmedia/stargazers"><img src="https://img.shields.io/github/stars/ttncode/openmedia?style=flat&color=12939c" alt="Stars" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-12939c" alt="MIT license" /></a>
+  </p>
+  <p><a href="README.md">English</a> | Tiếng Việt</p>
+</div>
+
+## Tính năng
+
+- Tải từ hơn 1000 trang web thông qua yt-dlp
+- Video MP4 và MKV với bộ chọn chất lượng
+- Âm thanh MP3, M4A, Opus, FLAC và WAV
+- Cắt theo khoảng thời gian
+- Phụ đề, nhúng vào video hoặc tách riêng dưới dạng SRT
+- Nhúng ảnh bìa, metadata và chương vào tệp
+- Hàng đợi hiển thị tiến độ trực tiếp, có thể hủy và giới hạn số lượng tải cùng lúc
+- Dán nhiều liên kết cùng lúc và tải playlist
+- Cookie cho video giới hạn độ tuổi hoặc bị chặn kiểm tra bot
+- Mật khẩu tùy chọn, giới hạn tốc độ yêu cầu và chặn địa chỉ mạng nội bộ
+- Lịch sử, kéo thả, dán bất kỳ đâu, phím tắt
+- Cài đặt được như một PWA với share target
+- Giao diện sáng và tối với bảy màu nhấn
+- Tiếng Anh và tiếng Việt
+
+<div align="center">
+  <img src="docs/public/screenshots/desktop-light.png" alt="OpenMedia trên desktop, giao diện sáng" width="70%" />
+  <img src="docs/public/screenshots/phone-dark.png" alt="OpenMedia trên điện thoại, giao diện tối" width="20%" />
+</div>
+
+## Cài đặt
+
+### Docker Compose
+
+Tải `compose.yaml` và `example.env` từ
+[bản phát hành mới nhất](https://github.com/ttncode/openmedia/releases/latest), sau đó
+sao chép tệp cấu hình mẫu:
+
+```bash
+cp example.env .env
+```
+
+Sửa `.env` và đặt `OPENMEDIA_PASSWORD` thành mật khẩu của riêng bạn. API sẽ
+không khởi động khi giá trị vẫn là `changeme`; chỉ để trống khi chạy riêng trên
+máy hoặc mạng cục bộ của bạn. Sau đó khởi động:
+
+```bash
+docker compose up -d
+```
+
+Mở `http://localhost:8080`.
+
+### Script cài đặt
+
+```bash
+curl -fsSL https://github.com/ttncode/openmedia/releases/latest/download/install.sh | bash
+```
+
+Script tạo một mật khẩu ngẫu nhiên và in mật khẩu cùng địa chỉ truy cập khi
+hoàn tất.
+
+### Từ mã nguồn
+
+```bash
+git clone https://github.com/ttncode/openmedia.git
+cd openmedia
+mise install
+mise run //apps/api:dev
+mise run //apps/web:dev
+```
+
+Mở `http://localhost:3000`.
+
+## Tài liệu
+
+- [Bắt đầu](docs/getting-started.md)
+- [Sử dụng](docs/usage.md)
+- [Cấu hình](docs/configuration.md)
+- [Triển khai](docs/deployment.md)
+- [Xử lý sự cố](docs/troubleshooting.md)
+- [Bảo mật](docs/security.md)
+
+## Dành cho lập trình viên
+
+Mỗi thư mục gốc cấu hình (`apps/api`, `apps/web`, `docs`) trả lời cùng một hợp
+đồng tác vụ: `install`, `format`/`format-fix`, `lint`, `check`, `test`,
+`build`, `ci-unit`, `checklist`. Chạy kiểm tra của một thư mục bằng `mise run
+//apps/api:ci-unit`, hoặc `mise run checklist` từ thư mục gốc dự án để chạy
+tất cả, đúng như những gì CI thực hiện.
+
+| Đường dẫn  | Nội dung                       |
+| ---------- | ------------------------------ |
+| `apps/api` | Backend Flask, tích hợp yt-dlp |
+| `apps/web` | Giao diện web Next.js          |
+| `docs`     | Trang tài liệu này             |
+
+Xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết quy ước nhánh và commit.
+
+## Cần trợ giúp
+
+- [Hướng dẫn xử lý sự cố](docs/troubleshooting.md)
+- [Báo cáo vấn đề](https://github.com/ttncode/openmedia/issues)
+- [Chính sách bảo mật](SECURITY.md)
+
+## Lời cảm ơn
+
+- [ReClip](https://github.com/averygan/reclip), dự án mà OpenMedia được xây dựng dựa trên
+- [yt-dlp](https://github.com/yt-dlp/yt-dlp)
+- [FFmpeg](https://ffmpeg.org)
+- [Deno](https://deno.com)
+- [Next.js](https://nextjs.org)
+- [Flask](https://flask.palletsprojects.com)
+- [Phosphor Icons](https://phosphoricons.com)
+- Bộ công cụ [scaffold](https://github.com/ttncode/scaffold) đã tạo dự án này
+
+## Miễn trừ trách nhiệm
+
+OpenMedia dành cho mục đích cá nhân. Hãy tôn trọng luật bản quyền và điều
+khoản dịch vụ của các trang bạn tải xuống.
+
+## Giấy phép
+
+MIT, xem [LICENSE](LICENSE) và [NOTICE](NOTICE).

apps/api/.dockerignore

@@ -7,3 +7,4 @@ __pycache__
 .env
 .env.*
 .git
+data/