diff --git a/README.md b/README.md index 88c05f3d..679bc12d 100644 --- a/README.md +++ b/README.md @@ -62,6 +62,15 @@ See [docs/cli.md](./docs/cli.md). Every platform has a recommended route below. On Windows that is the Microsoft Store; everywhere else it is the installer from the [GitHub Releases](https://github.com/getopenscreen/openscreen/releases) page. +### System requirements + +- **Windows**: version 1903+ (build 18362) with Intel 8th Gen / AMD Ryzen 2000 series or newer minimum; Windows 11 with Intel 12th Gen / Ryzen 4000 series or newer recommended +- **macOS**: 12.3 (Monterey) or later — required by ScreenCaptureKit for native capture +- **Linux**: `xdg-desktop-portal` and PipeWire for native capture and system audio; recording still works without them through the browser-capture fallback, with fewer capabilities (see [Platform differences](#platform-differences)) +- **RAM**: 8 GB minimum, 16 GB recommended + +Full table and notes on older integrated graphics: [system requirements](https://getopenscreen.com/docs/installation#system-requirements). + ### macOS Download the `.dmg` installer directly from the [Releases page](https://github.com/getopenscreen/openscreen/releases) and drag OpenScreen into your Applications folder. Builds from 1.9.0 onward are signed with a Developer ID certificate and notarized by Apple, so Gatekeeper does not block them and no terminal step is needed. diff --git a/website/docs/installation.md b/website/docs/installation.md index 4a7e8780..d71f0197 100644 --- a/website/docs/installation.md +++ b/website/docs/installation.md @@ -18,6 +18,19 @@ keywords: Download the latest installer for your platform from the [download page](/download), or straight from [GitHub Releases](https://github.com/getopenscreen/openscreen/releases). +## System requirements + +| | Minimum | Recommended | +|---|---|---| +| **Windows** | Windows 10 version 1903 (build 18362) or later, Intel 8th Gen / AMD Ryzen 2000 series or newer | Windows 11, Intel 12th Gen / AMD Ryzen 4000 series or newer | +| **macOS** | macOS 12.3 (Monterey) — required by ScreenCaptureKit for native capture | macOS 14 or later | +| **Linux** | `xdg-desktop-portal` and PipeWire for native capture and system audio (default on Ubuntu 22.04+, Fedora 34+) — recording still works without them through the [browser-capture fallback](#platform-differences), with fewer capabilities | Same, kept up to date | +| **RAM** | 8 GB | 16 GB | + +:::note Older integrated graphics on Windows +Machines with integrated graphics older than roughly 8th-generation Intel (or the equivalent AMD Ryzen 2000 series) are not blocked from installing, but some have known driver stability issues that can make a recording fail to stop and save — see [#460](https://github.com/getopenscreen/openscreen/issues/460). If you hit this, open the tray icon or **Help → Save Diagnostics** right after the failure (before starting another recording) and attach the file to a bug report. +::: + ## macOS Download the `.dmg` installer from [Releases](https://github.com/getopenscreen/openscreen/releases) and drag OpenScreen into your Applications folder. Builds from 1.9.0 onward are signed with a Developer ID certificate and notarized by Apple, so Gatekeeper does not block them and no terminal step is needed. diff --git a/website/src/pages/download.tsx b/website/src/pages/download.tsx index fec64fe1..03f75fd8 100644 --- a/website/src/pages/download.tsx +++ b/website/src/pages/download.tsx @@ -11,6 +11,7 @@ import { ShieldCheck, TerminalSquare, } from "lucide-react"; +import type { ReactNode } from "react"; import { type AssetKind, findAsset, formatSize, type LatestRelease } from "../lib/release"; import { jsonLd, SOFTWARE_ID, softwareApplicationLd, WEBSITE_ID } from "../lib/structured-data"; @@ -33,7 +34,7 @@ type PlatformSpec = { icon: typeof Apple; /** One row per artifact the platform actually ships. */ options: { kind: AssetKind; label: string; sublabel: string }[]; - footnote?: string; + footnote?: ReactNode; }; const PLATFORMS: PlatformSpec[] = [ @@ -52,7 +53,13 @@ const PLATFORMS: PlatformSpec[] = [ name: "Windows", icon: AppWindow, options: [{ kind: "windows", label: "Windows 10 & 11", sublabel: "Installer · .exe" }], - footnote: "System audio is captured without extra drivers.", + footnote: ( + <> + System audio is captured without extra drivers. Integrated graphics older than ~8th-gen + Intel (or the AMD Ryzen 2000 series equivalent) may hit known recording-stop issues — see{" "} + system requirements. + + ), }, { id: "linux",