Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -176,7 +176,7 @@ You may need to grant screen recording permissions depending on your desktop env
Everything in the editor and export is the same on macOS, Windows, and Linux: zooms, backgrounds, motion blur, crop/trim/speed, blur regions, annotations, auto-captions, AI editing, projects, export, and all languages. All three now record through a native capture pipeline; the remaining differences are narrower than they used to be:

- **Native recording**: macOS (ScreenCaptureKit), Windows (Windows Graphics Capture), and Linux (PipeWire via the ScreenCast portal) all record through a native pipeline for higher quality and clean window-level capture. On Linux the browser pipeline stays as an automatic fallback if the helper isn't available.
- **Custom cursors**: on macOS and Windows the real cursor is captured with shape, type, and clicks. Linux captures position and cursor shape through the portal, so the editable cursor overlay works there too. Click effects work on Linux as well, but not through the portal — Wayland exposes no portal for mouse buttons, so the capture helper reads the left button from evdev, which needs your user in the `input` group. Without that, recording is unaffected and every cursor sample is simply a move.
- **Custom cursors**: on macOS and Windows the real cursor is captured with shape, type, and clicks. Linux captures position and cursor shape through the portal, so the editable cursor overlay works there too. Click effects work on Linux as well, but not through the portal — Wayland exposes no portal for mouse buttons, so the capture helper reads the left button from evdev, which needs read access to your mouse: a udev rule for pointer devices (recommended) or the `input` group, set up as [Mouse clicks on Wayland](https://getopenscreen.com/docs/installation#mouse-clicks-on-wayland) shows. Without that, recording is unaffected and every cursor sample is simply a move.
- **Webcam**: every platform saves the webcam as a separate file next to the screen recording. Windows captures it natively in the recording helper; macOS and Linux record it in the app. It works as a picture-in-picture overlay on all three.
- **System audio** support varies by OS:
- **macOS**: works on every supported version. On macOS 14.2+ you'll be prompted to grant audio capture permission.
Expand Down
8 changes: 5 additions & 3 deletions electron/native/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -227,14 +227,16 @@ electron/native/bin/linux-x64/openscreen-pipewire-helper '{"probeOnly":true}'

### Known gaps

- **Mouse clicks need the `input` group.** Wayland exposes no portal for input
- **Mouse clicks need read access to evdev.** Wayland exposes no portal for input
events, so the helper reads left-button presses straight from evdev
(`/dev/input/event*`). Those nodes are `root:input`, so a user outside the
(`/dev/input/event*`). Those nodes are `root:input`, so a user with neither a
udev `uaccess` rule for pointer devices (recommended) nor membership in the
`input` group gets no readable device and every sample's `interactionType`
stays `"move"` — the same as before. When a device is readable, the coinciding
sample is tagged `"click"`. Scope is deliberately narrow: `BTN_LEFT` only,
never keystrokes (see `pipewire-capture/src/input.rs`), and
`OPENSCREEN_DISABLE_CLICK_CAPTURE=1` turns it off entirely.
`OPENSCREEN_DISABLE_CLICK_CAPTURE=1` turns it off entirely. User setup:
[Mouse clicks on Wayland](../../website/docs/installation.md#mouse-clicks-on-wayland).
- **The user picks a source twice.** Electron's `desktopCapturer` raises its own
portal dialog for the video, and this helper raises a second one for the cursor.
Collapsing them requires one portal session serving both, which is why the
Expand Down
2 changes: 1 addition & 1 deletion website/docs/guides/product-demo-video.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ On Windows, OpenScreen keeps the HUD and the Notes window out of the capture. On

1. On Windows and macOS, open the source picker and choose a display under **Screens** or a single window under **Windows**. On macOS 15.2 and later, you choose the display or window in Apple's system picker instead. On Linux there is no in-app picker: the system portal asks for the source on every take. OpenScreen has no region capture, so record the window or the screen, then crop the clip in the editor.
2. Turn on the microphone and check its level meter. Turn on system audio if the product makes sound, and the webcam if you want to appear on screen.
3. Keep the editable cursor mode, the default: the pointer is recorded as data, so you can restyle it later. Clicks are recorded on Windows. On macOS they need the Accessibility permission. On Linux your user must be in the `input` group, and touchpad tap-to-click is not captured ([details](../installation.md#mouse-clicks-on-wayland)).
3. Keep the editable cursor mode, the default: the pointer is recorded as data, so you can restyle it later. Clicks are recorded on Windows. On macOS they need the Accessibility permission. On Linux your user needs read access to the mouse, through a udev rule (recommended) or the `input` group, and touchpad tap-to-click is not captured ([details](../installation.md#mouse-clicks-on-wayland)).
4. Press record. A 3-2-1 countdown runs first and cannot be turned off.

OpenScreen captures at a 60 fps target, up to 3840×2160 on Windows and macOS. On Linux the size is whatever the compositor hands over. While recording you can pause, restart the take, cancel it, or stop.
Expand Down
2 changes: 1 addition & 1 deletion website/docs/recording.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ On Windows, macOS, and Linux, a cursor-mode toggle switches between:
What the editable overlay captures depends on the platform:
- **Windows** — the real cursor shape and clicks.
- **macOS** — the cursor shape and clicks, which need the Accessibility permission. In this mode, pressing record without it opens the permissions window instead of starting (see [macOS installation](./installation.md#macos)).
- **Linux** — position and shape through the ScreenCast portal, plus left clicks when your user is in the `input` group (see [Mouse clicks on Wayland](./installation.md#mouse-clicks-on-wayland)).
- **Linux** — position and shape through the ScreenCast portal, plus left clicks when your user can read the mouse, through a udev rule (recommended) or the `input` group (see [Mouse clicks on Wayland](./installation.md#mouse-clicks-on-wayland)).

A Linux take that falls back to [browser capture](#native-vs-browser-capture) records the system cursor, whichever mode you picked.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Unter Windows hält OpenScreen das HUD und das Notizfenster aus der Aufnahme her

1. Unter Windows und macOS öffnest du die Quellenauswahl und wählst unter **Bildschirme** einen Bildschirm oder unter **Fenster** ein einzelnes Fenster. Unter macOS 15.2 und neuer wählst du Bildschirm oder Fenster stattdessen in der Systemauswahl von Apple aus. Unter Linux gibt es keine Auswahl in der App: Das Systemportal fragt bei jedem Take nach der Quelle. OpenScreen hat keine Bereichsaufnahme. Nimm also das Fenster oder den Bildschirm auf und schneide den Clip dann im Editor zu.
2. Schalte das Mikrofon ein und prüfe seine Pegelanzeige. Schalte Systemaudio ein, wenn das Produkt Töne macht, und die Webcam, wenn du im Bild sein willst.
3. Behalte den bearbeitbaren Cursormodus, den Standard: Der Zeiger wird als Daten aufgezeichnet, du kannst ihn also später neu gestalten. Klicks werden unter Windows aufgezeichnet. Unter macOS brauchen sie die Berechtigung „Bedienungshilfen“. Unter Linux muss dein Benutzer in der Gruppe `input` sein, und Tippen zum Klicken auf dem Touchpad wird nicht erfasst ([Details](../installation.md#mouse-clicks-on-wayland)).
3. Behalte den bearbeitbaren Cursormodus, den Standard: Der Zeiger wird als Daten aufgezeichnet, du kannst ihn also später neu gestalten. Klicks werden unter Windows aufgezeichnet. Unter macOS brauchen sie die Berechtigung „Bedienungshilfen“. Unter Linux braucht dein Benutzer Lesezugriff auf die Maus, über eine udev-Regel (empfohlen) oder die Gruppe `input`, und Tippen zum Klicken auf dem Touchpad wird nicht erfasst ([Details](../installation.md#mouse-clicks-on-wayland)).
4. Starte die Aufnahme. Vorher läuft ein 3-2-1-Countdown, der sich nicht abschalten lässt.

OpenScreen nimmt mit angestrebten 60 fps auf, unter Windows und macOS bis 3840×2160. Unter Linux entspricht die Größe dem, was der Compositor liefert. Während der Aufnahme kannst du pausieren, den Take neu starten, ihn abbrechen oder stoppen.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ Unter Windows, macOS und Linux wechselt ein Schalter für den Cursormodus zwisch
Was das bearbeitbare Overlay erfasst, hängt von der Plattform ab:
- **Windows**: die echte Cursorform und Klicks.
- **macOS**: Cursorform und Klicks, wofür die Berechtigung „Bedienungshilfen“ nötig ist. Fehlt sie, öffnet ein Klick auf Aufnahme in diesem Modus das Berechtigungsfenster, statt die Aufnahme zu starten (siehe [Installation unter macOS](./installation.md#macos)).
- **Linux**: Position und Form über das ScreenCast-Portal, dazu Linksklicks, wenn dein Benutzer in der Gruppe `input` ist (siehe [Mausklicks unter Wayland](./installation.md#mouse-clicks-on-wayland)).
- **Linux**: Position und Form über das ScreenCast-Portal, dazu Linksklicks, wenn dein Benutzer Lesezugriff auf die Maus hat, über eine udev-Regel (empfohlen) oder die Gruppe `input` (siehe [Mausklicks unter Wayland](./installation.md#mouse-clicks-on-wayland)).

Ein Linux-Take, der auf die [Browser-Aufnahme](#native-vs-browser-capture) ausweicht, zeichnet den Systemcursor auf, egal welchen Modus du gewählt hast.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Looms Plandetails in diesem Abschnitt sind Stand September 2026.
## Erste Schritte {#getting-started}

1. Lade OpenScreen von der [Download-Seite](/download/) herunter. Unter Linux wähle das AppImage, `.deb`, `.rpm` oder `.pacman`, oder nutze das Nix-Flake.
2. Folge der [Installation](/docs/installation/). Unter macOS erteile die Berechtigungen im Fenster, das sich beim ersten Start öffnet. Unter Linux braucht die Aufnahme PipeWire und `xdg-desktop-portal`, und [Mausklicks unter Wayland](/docs/installation/#mouse-clicks-on-wayland) brauchen deinen Nutzer in der Gruppe `input`.
2. Folge der [Installation](/docs/installation/). Unter macOS erteile die Berechtigungen im Fenster, das sich beim ersten Start öffnet. Unter Linux braucht die Aufnahme PipeWire und `xdg-desktop-portal`, und [Mausklicks unter Wayland](/docs/installation/#mouse-clicks-on-wayland) brauchen Lesezugriff auf die Maus, über eine udev-Regel (empfohlen) oder die Gruppe `input`.
3. Mach eine erste Aufnahme mit dem [Schnellstart](/docs/quick-start/), exportiere sie dann als MP4 und teile die Datei, wo dein Team schon arbeitet.

Vergleichst du auch andere Tools? Siehe die [Screen-Studio-Alternative](/alternatives/screen-studio/), [OpenScreen vs Cap](/compare/openscreen-vs-cap/), [OpenScreen vs OBS Studio](/compare/openscreen-vs-obs/) und die [Camtasia-Alternative](/alternatives/camtasia/), oder geh zurück zur [OpenScreen-Startseite](/).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Ein paar Details sind in der Praxis wichtig:
- **Die Ergebnisse sind gewöhnliche Zooms.** Klick einen an, um Tiefe, 3D-Kamera oder Fokus zu ändern, zieh an seinen Rändern, um Start und Ende zu verschieben, oder lösche ihn.
- **Er läuft nach jeder Aufnahme.** Jede neue Aufnahme bekommt ihre Zooms, sobald sie im Editor geöffnet wird. Wenn du das nicht willst, schalte **Auto-zoom after recording** im Modus **Record** des Editors aus. Um ihn bei Bedarf auszuführen, wähle im Editor **Automatic zooms** oder übergib `--auto-zoom` in der Kommandozeile.
- **Er sagt dir, wenn nichts infrage kommt.** Der Editor meldet, dass keine Auto-Zoom-Momente gefunden wurden.
- **Er arbeitet mit aufgezeichneten Klicks.** Klicks werden unter Windows aufgezeichnet. Unter macOS brauchen sie die Berechtigung „Bedienungshilfen“, und unter Linux muss dein Nutzer in der Gruppe `input` sein.
- **Er arbeitet mit aufgezeichneten Klicks.** Klicks werden unter Windows aufgezeichnet. Unter macOS brauchen sie die Berechtigung „Bedienungshilfen“, und unter Linux braucht dein Nutzer Lesezugriff auf die Maus, über eine udev-Regel (empfohlen) oder die Gruppe `input` ([Mausklicks unter Wayland](/docs/installation/#mouse-clicks-on-wayland)).
- **Zeigen ist nicht Klicken.** Ein Zeiger, den du stillhältst, während du über etwas sprichst, bekommt keinen Zoom. Füge mit `Z` einen von Hand hinzu.

Dasselbe Menü hat einen zweiten Eintrag, **Smart cuts**, markiert mit *With AI*. Das ist eine andere Funktion: Sie bittet den optionalen Chat-Agenten, Leerlauf herauszuschneiden. Sie wartet auf das Transkript der Aufnahme und funktioniert erst, wenn du einen KI-Anbieter mit deinem eigenen Schlüssel verbunden hast. Siehe [KI-Bearbeitung](/docs/ai-editing/).
Expand All @@ -78,7 +78,7 @@ Ein manueller Zoom mit manuellem Fokus braucht keine Cursordaten, funktioniert a

Dieselbe aufgezeichnete Bewegung steuert den Cursor im Export. Der Bereich **Cursor** zeigt oder verbirgt ihn und legt Größe, Glättung, Bewegungsunschärfe, Klick-Bounce und Klick-Impact fest. Der Cursorpfad wird für Vorschau und Export gleich geglättet, sodass die Vorschau der Datei entspricht.

Klick-Bounce braucht aufgezeichnete Klicks. Unter macOS braucht das die Berechtigung „Bedienungshilfen“, unter Linux muss dein Nutzer in der Gruppe `input` sein. [Aufnahme](/docs/recording/) listet, was jede Plattform erfasst.
Klick-Bounce braucht aufgezeichnete Klicks. Unter macOS braucht das die Berechtigung „Bedienungshilfen“, unter Linux Lesezugriff auf die Maus, über eine udev-Regel oder die Gruppe `input`. [Aufnahme](/docs/recording/) listet, was jede Plattform erfasst.

<DemoLoop name="3d-cursors" />

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Diese Seite wird vom OpenScreen-Projekt veröffentlicht. Die Angaben zu Screen S
| Aufnahme | PipeWire über das ScreenCast-Portal, mit 60 fps als Ziel. Die Größe bestimmt der Compositor |
| Kodierung während der Aufnahme | H.264 über VAAPI, dann Vulkan, dann Software |
| Systemton | Der PipeWire-Sink-Monitor, gemischt mit dem Mikrofon |
| Cursor | Position und Form vom Portal. Linksklicks mit der Gruppe `input` |
| Cursor | Position und Form vom Portal. Linksklicks mit einer udev-Regel oder der Gruppe `input` |
| Untertitel | Lokales Whisper auf Vulkan, mit CPU-Fallback. In das Video eingebrannt |
| Export | MP4 (H.264) oder GIF, kein Wasserzeichen. H.264 auf der GPU über VAAPI, wenn der Treiber es erlaubt |
| Eingebaute Updates | AppImage, `.deb`, `.rpm` und `.pacman`. Nicht Nix |
Expand All @@ -39,15 +39,15 @@ OpenScreen nimmt den Bildschirm unter Linux mit einem eigenen nativen Helferprog
- **Systemton von PipeWire.** Er kommt vom Monitor des Standard-PipeWire-Sinks und wird mit dem Mikrofon zu einer AAC-Spur gemischt. Dafür muss PipeWire der Sound-Server sein, wie standardmäßig ab Ubuntu 22.10 und ab Fedora 34.
- **Mikrofonwahl.** Das HUD listet jedes Eingabegerät mit einem Live-Pegelmesser. Das Helferprogramm findet den passenden PipeWire-Knoten anhand seiner Beschreibung.
- **Ein bearbeitbarer Cursor.** Im Standardmodus **Use editable cursor** meldet das Portal Position und Form des Cursors, sodass du ihn im Editor neu gestalten kannst. Der Modus **Use system cursor** nimmt den Zeiger so auf, wie er ist.
- **Klicks unter Wayland.** Wayland hat kein Portal für Eingabeereignisse, deshalb liest OpenScreen Linksklicks über evdev. Das funktioniert, wenn dein Nutzer in der Gruppe `input` ist, und OpenScreen liest nur die linke Taste, niemals Tastenanschläge. Die Gruppe selbst ist breiter gefasst: Sie erlaubt jedem Programm, das du ausführst, jedes Eingabegerät zu lesen, Tastatur eingeschlossen. Ohne die Gruppe funktioniert die Aufnahme weiterhin, und jeder Cursor-Messpunkt wird als Bewegung gespeichert. [Mausklicks unter Wayland](/docs/installation/#mouse-clicks-on-wayland) hat den Befehl dafür.
- **Klicks unter Wayland.** Wayland hat kein Portal für Eingabeereignisse, deshalb liest OpenScreen Linksklicks über evdev. Das funktioniert, wenn dein Nutzer Lesezugriff auf die Maus hat, und OpenScreen nutzt nur das Drücken der linken Maustaste und ignoriert alle anderen Ereignisse, Tastatureingaben werden also nie aufgezeichnet. Empfohlen ist eine udev-Regel, die deiner Desktop-Sitzung Zugriff auf Mäuse und Touchpads gibt, Tastaturen ausgenommen. Die Gruppe `input` funktioniert auch, ist aber breiter gefasst: Sie erlaubt jedem Programm, das du ausführst, jedes Eingabegerät zu lesen, Tastatur eingeschlossen. Ohne Regel und ohne Gruppe funktioniert die Aufnahme weiterhin, und jeder Cursor-Messpunkt wird als Bewegung gespeichert. [Mausklicks unter Wayland](/docs/installation/#mouse-clicks-on-wayland) hat die Befehle dafür.
- **Browser-Aufnahme nur als Fallback.** Chromiums Aufnahme übernimmt nur in einem Build, dem das Helferprogramm fehlt. Ein Helferprogramm, das fehlschlägt, meldet einen Fehler, statt auf den Fallback umzuschalten. Siehe [Aufnahme](/docs/recording/).

## Feinschliff im Stil von Screen Studio unter Linux {#screen-studio-style-polish-on-linux}

Screen Studio unterstützt nur macOS (Stand September 2026). OpenScreen bietet denselben Feinschliff unter Linux, und seine Bearbeitungswerkzeuge sind unter Windows, macOS und Linux dieselben.

- **Automatische Zooms.** **Auto-enhance → Automatic zooms** platziert Zooms auf den aufgezeichneten Klicks, ohne Netzwerkaufruf und ohne Modell. Manuelle Zooms haben sechs Tiefen. Mehr zu [Auto-Zoom](/features/auto-zoom/).
- **Cursor-Gestaltung.** Blende den Cursor ein oder aus, ändere seine Größe, glätte ihn und füge Bewegungsunschärfe sowie einen Klick-Bounce hinzu. Klickeffekte brauchen aufgezeichnete Klicks, also wieder die Gruppe `input`.
- **Cursor-Gestaltung.** Blende den Cursor ein oder aus, ändere seine Größe, glätte ihn und füge Bewegungsunschärfe sowie einen Klick-Bounce hinzu. Klickeffekte brauchen aufgezeichnete Klicks, also wieder dieselbe udev-Regel oder die Gruppe `input`.
- **Hintergründe und Rahmung.** 18 mitgelieferte Wallpaper, eine Volltonfarbe, ein Verlauf oder ein eigenes Bild, mit Innenabstand, abgerundeten Ecken und Schatten. Ausgabe in 16:9, 9:16, 1:1 und weiteren Seitenverhältnissen.
- **Lokale Untertitel.** whisper.cpp läuft auf deinem Rechner, auf Vulkan mit CPU-Fallback. Es nutzt ein Whisper-Small-Modell von etwa 264 MB, einmalig heruntergeladen. Untertitel werden in das Video eingebrannt, und das Löschen von Wörtern im Transkript schneidet sie aus dem Video. Mehr zu [Untertiteln](/features/captions/).
- **Webcam-Layouts.** Bild-im-Bild und andere Layouts, mit entferntem, verwischtem oder ersetztem Kamerahintergrund, ohne Greenscreen.
Expand All @@ -71,7 +71,7 @@ Screen Studio unterstützt nur macOS (Stand September 2026). OpenScreen bietet d
## Erste Schritte {#getting-started}

1. Lade das Paket für deine Distribution von der [Download-Seite](/download/) herunter, oder nutze das Nix-Flake.
2. Folge den [Linux-Installationsschritten](/docs/installation/#linux). Füge deinen Nutzer der Gruppe `input` hinzu, wenn du Klicks aufzeichnen willst und mit dem einverstanden bist, was diese Gruppe erlaubt.
2. Folge den [Linux-Installationsschritten](/docs/installation/#linux). Wenn du Klicks aufzeichnen willst, richte die udev-Regel oder die Gruppe `input` aus [Mausklicks unter Wayland](/docs/installation/#mouse-clicks-on-wayland) ein.
3. Mach eine erste Aufnahme mit dem [Schnellstart](/docs/quick-start/) und beantworte den Portal-Dialog, wenn er sich öffnet. Die Aufnahme öffnet sich im Editor mit bereits gesetzten automatischen Zooms.

Auf einem anderen System? Siehe die Seiten zu [Windows](/screen-recorder-windows/) und [macOS](/screen-recorder-mac/). Kommst du von einer Mac-App? Siehe die [Screen-Studio-Alternative](/alternatives/screen-studio/). Oder geh zurück zur [OpenScreen-Startseite](/).
Expand Down
Loading
Loading