You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 96bdf58
Browse filesBrowse the repository at this point in the historyBrowse files
docs(website): describe v2's macOS permissions on the install page
The macOS section still sent users to System Settings to grant Screen
Recording and Accessibility by hand, and warned that macOS 15+ re-asks.
- First launch opens the permissions window; it reopens from the menu
bar icon (Permissions…).
- macOS 15.2+: Apple's picker needs no Screen Recording; system audio
asks for System Audio Recording Only.
- macOS 13 to 15.1: own picker, Screen Recording covers system audio;
the periodic alert is stated for 15.0 and 15.1 only.
- Requirements: microphone needs macOS 15, recommended 15.2.
- Same update in the 7 translations.
Copy file name to clipboardExpand all lines: website/docs/installation.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ On Windows, the recommended route is the [Microsoft Store](#windows). Everywhere
26
26
|| Minimum | Recommended |
27
27
|---|---|---|
28
28
|**Windows**| Windows 10 version 1903 (build 18362) or later, x64, Intel 8th Gen / AMD Ryzen 2000 series or newer. Native capture needs Windows 10 version 2004 (build 19041) or later; older builds record through the [browser-capture fallback](#platform-differences)| Windows 11, Intel 12th Gen / AMD Ryzen 4000 series or newer |
29
-
|**macOS**| macOS 13 (Ventura) — required by ScreenCaptureKit for capture| macOS 14 or later |
29
+
|**macOS**| macOS 13 (Ventura) — required by ScreenCaptureKit for capture. Recording the microphone needs macOS 15 or later | macOS 15.2 or later |
30
30
|**Linux**| x64. `xdg-desktop-portal` and PipeWire, which recording needs: the native capture helper goes through them, and a failure there is reported as an error. The [browser-capture fallback](#platform-differences) only takes over when a build is missing the helper itself. System audio additionally needs PipeWire as the sound server (the default on [Ubuntu 22.10+](https://discourse.ubuntu.com/t/kinetic-kudu-release-notes/27976) and [Fedora 34+](https://fedoraproject.org/wiki/Changes/DefaultPipeWire)). Recording mouse clicks on Wayland needs your user in the `input` group — see [Mouse clicks on Wayland](#mouse-clicks-on-wayland)| Same, kept up to date |
31
31
|**RAM**| 8 GB | 16 GB |
32
32
@@ -38,11 +38,12 @@ Machines with integrated graphics older than roughly 8th-generation Intel (or th
38
38
39
39
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.
40
40
41
-
Then go to **System Settings → Privacy & Security** and grant **Screen Recording** and **Accessibility** to OpenScreen. Screen Recording is what lets it capture at all. Accessibility is what the default editable cursor needs to record the cursor shape and clicks: in that mode, pressing record without it opens a prompt that links to the setting, and recording starts once you have granted it and press record again.
41
+
The first time you open it, OpenScreen shows a permissions window that lists every permission it uses, each with a button to grant it. You can reopen it at any time from OpenScreen's menu bar icon: **Permissions…**. What macOS asks for depends on its version:
42
42
43
-
:::note macOS 15 and later re-ask periodically
44
-
macOS re-requests screen-recording permission from time to time for every third-party screen recorder. That prompt comes from the operating system — it does not mean your install is broken or that an update went wrong. Grant it again when asked.
45
-
:::
43
+
-**macOS 15.2 and later:** you pick the screen or window in Apple's system picker, and that pick is your consent, so no **Screen Recording** permission is needed. System audio asks for its own, narrower permission: **System Audio Recording Only**.
44
+
-**macOS 13 to 15.1:** OpenScreen uses its own source picker and needs **Screen Recording**, which also covers system audio. On 15.0 and 15.1, macOS also asks from time to time whether OpenScreen may access the screen directly, without the system picker: allow it.
45
+
46
+
**Accessibility** is what the default editable cursor needs to record the cursor shape and clicks: in that mode, pressing record without it opens the permissions window, and recording starts once you have granted it and press record again.
46
47
47
48
:::tip Upgrading from a version older than 1.9.0?
48
49
Those builds were not signed with a Developer ID certificate, and macOS ties Screen Recording and Accessibility grants to an app's signature — so it cannot tell the new build is the same app, and the permissions you granted the old one do not carry over. If a new version won't record even after granting them, remove OpenScreen's entries under both permissions in System Settings, then launch it again and grant them fresh.
@@ -153,7 +154,7 @@ The editing tools are the same everywhere — zooms, backgrounds, crop/trim/spee
153
154
| Capture pipeline | Native (ScreenCaptureKit) | Native (Windows Graphics Capture) on build 19041 and later; browser fallback on older builds or without the helper | Native (PipeWire via the ScreenCast portal); browser fallback without the helper, losing hardware encode and cursor telemetry |
154
155
| Custom cursor / click effects | ✅ — clicks and cursor shape need the Accessibility permission | ✅ | ✅ on Wayland — click capture needs the `input` group ([details](#mouse-clicks-on-wayland)) |
155
156
| Webcam | Browser capture, saved as a separate file (still works as PiP) | Native capture, saved as a separate file | Browser capture, saved as a separate file (still works as PiP) |
156
-
| System audio | Works out of the box; permission prompt on macOS 14.2+ | Works out of the box | Needs PipeWire as the sound server (default on Ubuntu 22.10+, Fedora 34+) |
157
+
| System audio | Works out of the box; its own permission prompt on macOS 15.2+, covered by Screen Recording on older versions| Works out of the box | Needs PipeWire as the sound server (default on Ubuntu 22.10+, Fedora 34+) |
157
158
| MP4 export | ✅ | ✅ | ✅ — H.264 on the GPU through VAAPI when the GPU stack allows it (see the note below), software otherwise; H.265 is software-only |
158
159
| GIF export | ✅ | ✅ | ✅ |
159
160
| On-device transcription | Metal (Apple Silicon) / CPU | Vulkan / CPU | Vulkan / CPU |
Copy file name to clipboardExpand all lines: website/i18n/de/docusaurus-plugin-content-docs/current/installation.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ Unter Windows ist der [Microsoft Store](#windows) der empfohlene Weg. Auf allen
26
26
|| Minimum | Empfohlen |
27
27
|---|---|---|
28
28
|**Windows**| Windows 10 Version 1903 (Build 18362) oder neuer, x64, Intel ab 8. Generation / AMD Ryzen ab Serie 2000. Die native Aufnahme braucht Windows 10 Version 2004 (Build 19041) oder neuer; ältere Builds nehmen über die [Browser-Aufnahme als Fallback](#platform-differences) auf | Windows 11, Intel ab 12. Generation / AMD Ryzen ab Serie 4000 |
29
-
|**macOS**| macOS 13 (Ventura), das ScreenCaptureKit für die Aufnahme voraussetzt| macOS 14 oder neuer |
29
+
|**macOS**| macOS 13 (Ventura), das ScreenCaptureKit für die Aufnahme voraussetzt. Die Mikrofonaufnahme braucht macOS 15 oder neuer | macOS 15.2 oder neuer |
30
30
|**Linux**| x64. `xdg-desktop-portal` und PipeWire, die die Aufnahme braucht: Das native Aufnahme-Hilfsprogramm läuft über sie, und schlägt dort etwas fehl, wird das als Fehler gemeldet. Die [Browser-Aufnahme als Fallback](#platform-differences) springt nur ein, wenn einem Build das Hilfsprogramm selbst fehlt. Systemaudio braucht zusätzlich PipeWire als Soundserver (Standard ab [Ubuntu 22.10](https://discourse.ubuntu.com/t/kinetic-kudu-release-notes/27976) und [Fedora 34](https://fedoraproject.org/wiki/Changes/DefaultPipeWire)). Damit unter Wayland Mausklicks aufgenommen werden, muss dein Benutzer in der Gruppe `input` sein, siehe [Mausklicks unter Wayland](#mouse-clicks-on-wayland)| Wie Minimum, jeweils aktuell |
31
31
|**RAM**| 8 GB | 16 GB |
32
32
@@ -38,11 +38,12 @@ Auf Rechnern mit integrierter Grafik, die älter ist als etwa Intels 8. Generati
38
38
39
39
Lade den `.dmg`-Installer von [Releases](https://github.com/getopenscreen/openscreen/releases) herunter und ziehe OpenScreen in deinen Ordner „Programme“. Builds ab 1.9.0 sind mit einem Developer-ID-Zertifikat signiert und von Apple notarisiert. Gatekeeper blockiert sie deshalb nicht, und du brauchst keinen Schritt im Terminal.
40
40
41
-
Öffne dann **Systemeinstellungen → Datenschutz & Sicherheit** und erteile OpenScreen die Berechtigungen **Bildschirmaufnahme** und **Bedienungshilfen**. Ohne „Bildschirmaufnahme“ kann OpenScreen überhaupt nicht aufnehmen. „Bedienungshilfen“ braucht der standardmäßige bearbeitbare Cursor, um Cursorform und Klicks aufzuzeichnen: In diesem Modus öffnet ein Klick auf Aufnahme ohne diese Berechtigung einen Hinweis mit einem Link zur Einstellung, und die Aufnahme startet, sobald du die Berechtigung erteilt und erneut auf Aufnahme geklickt hast.
41
+
Wenn du OpenScreen zum ersten Mal öffnest, zeigt es ein Berechtigungsfenster, das jede Berechtigung auflistet, die es nutzt, jeweils mit einer Schaltfläche, um sie zu erteilen. Du kannst es jederzeit über das OpenScreen-Symbol in der Menüleiste wieder öffnen: **Berechtigungen …**. Was macOS abfragt, hängt von der Version ab:
42
42
43
-
:::note macOS 15 und neuer fragt regelmäßig erneut
44
-
macOS fragt die Berechtigung zur Bildschirmaufnahme von Zeit zu Zeit neu ab, und zwar für jeden Bildschirmrekorder von Drittanbietern. Diese Abfrage kommt vom Betriebssystem. Sie bedeutet nicht, dass deine Installation defekt ist oder ein Update schiefgegangen ist. Erteile die Berechtigung erneut, wenn du gefragt wirst.
45
-
:::
43
+
-**macOS 15.2 und neuer:** Du wählst den Bildschirm oder das Fenster in der Systemauswahl von Apple aus, und diese Auswahl ist deine Zustimmung. Die Berechtigung **Bildschirmaufnahme** ist deshalb nicht nötig. Systemaudio fragt eine eigene, engere Berechtigung ab: **Nur Aufnahme von Systemaudio**.
44
+
-**macOS 13 bis 15.1:** OpenScreen nutzt seine eigene Quellenauswahl und braucht **Bildschirmaufnahme**, was auch Systemaudio abdeckt. Unter macOS 15.0 und 15.1 fragt macOS außerdem von Zeit zu Zeit, ob OpenScreen ohne die Systemauswahl direkt auf den Bildschirm zugreifen darf: Erlaube den Zugriff.
45
+
46
+
**Bedienungshilfen** braucht der standardmäßige bearbeitbare Cursor, um Cursorform und Klicks aufzuzeichnen: In diesem Modus öffnet ein Klick auf Aufnahme ohne diese Berechtigung das Berechtigungsfenster, und die Aufnahme startet, sobald du die Berechtigung erteilt und erneut auf Aufnahme geklickt hast.
46
47
47
48
:::tip Update von einer Version vor 1.9.0?
48
49
Diese Builds waren nicht mit einem Developer-ID-Zertifikat signiert, und macOS bindet die Berechtigungen für Bildschirmaufnahme und Bedienungshilfen an die Signatur einer App. macOS kann deshalb nicht erkennen, dass der neue Build dieselbe App ist, und die Berechtigungen der alten Version werden nicht übernommen. Wenn eine neue Version auch nach dem Erteilen nicht aufnimmt, entferne die Einträge von OpenScreen unter beiden Berechtigungen in den Systemeinstellungen, starte die App dann neu und erteile die Berechtigungen noch einmal.
@@ -153,7 +154,7 @@ Die Bearbeitungswerkzeuge sind überall gleich: Zooms, Hintergründe, Zuschneide
153
154
| Aufnahme-Pipeline | Nativ (ScreenCaptureKit) | Nativ (Windows Graphics Capture) ab Build 19041; Browser-Fallback auf älteren Builds oder ohne das Hilfsprogramm | Nativ (PipeWire über das ScreenCast-Portal); Browser-Fallback ohne das Hilfsprogramm, dann ohne Hardware-Encoding und ohne Cursor-Telemetrie |
154
155
| Eigener Cursor / Klickeffekte | ✅, Klicks und Cursorform brauchen die Berechtigung „Bedienungshilfen“ | ✅ | ✅ unter Wayland, die Klickerfassung braucht die Gruppe `input` ([Details](#mouse-clicks-on-wayland)) |
155
156
| Webcam | Browser-Aufnahme, als separate Datei gespeichert (funktioniert trotzdem als Bild-im-Bild) | Native Aufnahme, als separate Datei gespeichert | Browser-Aufnahme, als separate Datei gespeichert (funktioniert trotzdem als Bild-im-Bild) |
156
-
| Systemaudio | Funktioniert ohne Einrichtung; Berechtigungsabfrage ab macOS 14.2| Funktioniert ohne Einrichtung | Braucht PipeWire als Soundserver (Standard ab Ubuntu 22.10, Fedora 34) |
157
+
| Systemaudio | Funktioniert ohne Einrichtung; eigene Berechtigungsabfrage ab macOS 15.2, in älteren Versionen durch „Bildschirmaufnahme“ abgedeckt| Funktioniert ohne Einrichtung | Braucht PipeWire als Soundserver (Standard ab Ubuntu 22.10, Fedora 34) |
157
158
| MP4-Export | ✅ | ✅ | ✅, H.264 auf der GPU über VAAPI, wenn der Grafik-Stack es zulässt (siehe Hinweis unten), sonst in Software; H.265 nur in Software |
158
159
| GIF-Export | ✅ | ✅ | ✅ |
159
160
| Lokale Transkription | Metal (Apple Silicon) / CPU | Vulkan / CPU | Vulkan / CPU |
Copy file name to clipboardExpand all lines: website/i18n/es/docusaurus-plugin-content-docs/current/installation.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ En Windows, la vía recomendada es [Microsoft Store](#windows). En los demás si
26
26
|| Mínimo | Recomendado |
27
27
|---|---|---|
28
28
|**Windows**| Windows 10 versión 1903 (compilación 18362) o posterior, x64, Intel de 8.ª generación / AMD Ryzen serie 2000 o más reciente. La captura nativa necesita Windows 10 versión 2004 (compilación 19041) o posterior; las compilaciones anteriores graban con la [captura por navegador de respaldo](#platform-differences)| Windows 11, Intel de 12.ª generación / AMD Ryzen serie 4000 o más reciente |
29
-
|**macOS**| macOS 13 (Ventura), que ScreenCaptureKit exige para la captura| macOS 14 o posterior |
29
+
|**macOS**| macOS 13 (Ventura), que ScreenCaptureKit exige para la captura. Grabar el micrófono necesita macOS 15 o posterior | macOS 15.2 o posterior |
30
30
|**Linux**| x64. `xdg-desktop-portal` y PipeWire, que la grabación necesita: el módulo auxiliar de captura nativa pasa por ellos, y un fallo ahí se informa como error. La [captura por navegador de respaldo](#platform-differences) solo toma el relevo cuando a una compilación le falta el propio módulo auxiliar. El audio del sistema necesita además PipeWire como servidor de sonido (el predeterminado en [Ubuntu 22.10+](https://discourse.ubuntu.com/t/kinetic-kudu-release-notes/27976) y [Fedora 34+](https://fedoraproject.org/wiki/Changes/DefaultPipeWire)). Para grabar los clics del mouse en Wayland, tu usuario debe estar en el grupo `input`: consulta [Clics del mouse en Wayland](#mouse-clicks-on-wayland)| Lo mismo, actualizado |
31
31
|**RAM**| 8 GB | 16 GB |
32
32
@@ -38,11 +38,12 @@ Los equipos con gráficos integrados anteriores, aproximadamente, a la 8.ª gene
38
38
39
39
Descarga el instalador `.dmg` desde [Releases](https://github.com/getopenscreen/openscreen/releases) y arrastra OpenScreen a tu carpeta Aplicaciones. Las compilaciones a partir de la 1.9.0 están firmadas con un certificado Developer ID y notarizadas por Apple, así que Gatekeeper no las bloquea y no hace falta ningún paso en la terminal.
40
40
41
-
Después, ve a **Ajustes del Sistema → Privacidad y seguridad** y concede a OpenScreen los permisos **Grabación de pantalla** y **Accesibilidad**. Sin Grabación de pantalla, no puede capturar nada. Accesibilidad es lo que necesita el cursor editable predeterminado para registrar la forma del cursor y los clics: en ese modo, si presionas grabar sin haberlo concedido, se abre un aviso con un enlace al ajuste, y la grabación empieza cuando lo concedes y vuelves a presionar grabar.
41
+
La primera vez que lo abres, OpenScreen muestra una ventana de permisos con todos los permisos que usa, cada uno con un botón para concederlo. Puedes volver a abrirla en cualquier momento desde el ícono de OpenScreen en la barra de menús: **Permisos…**. Lo que pide macOS depende de su versión:
42
42
43
-
:::note macOS 15 y posteriores vuelven a pedir el permiso periódicamente
44
-
macOS vuelve a solicitar de vez en cuando el permiso de grabación de pantalla para todos los grabadores de pantalla de terceros. Ese aviso lo muestra el sistema operativo: no significa que tu instalación esté dañada ni que una actualización haya fallado. Concédelo de nuevo cuando te lo pida.
45
-
:::
43
+
-**macOS 15.2 y posteriores:** eliges la pantalla o la ventana en el selector del sistema de Apple, y esa elección es tu consentimiento, así que no hace falta el permiso **Grabación de pantalla**. El audio del sistema pide su propio permiso, más limitado: **Solo grabación del audio del sistema**.
44
+
-**macOS 13 a 15.1:** OpenScreen usa su propio selector de fuente y necesita **Grabación de pantalla**, que también cubre el audio del sistema. En las versiones 15.0 y 15.1, macOS además pregunta de vez en cuando si OpenScreen puede acceder directamente a la pantalla, sin el selector del sistema: permítelo.
45
+
46
+
**Accesibilidad** es lo que necesita el cursor editable predeterminado para registrar la forma del cursor y los clics: en ese modo, si presionas grabar sin haberlo concedido, se abre la ventana de permisos, y la grabación empieza cuando lo concedes y vuelves a presionar grabar.
46
47
47
48
:::tip ¿Actualizas desde una versión anterior a la 1.9.0?
48
49
Esas compilaciones no estaban firmadas con un certificado Developer ID, y macOS asocia los permisos de Grabación de pantalla y Accesibilidad a la firma de la app. Por eso no puede saber que la nueva compilación es la misma app, y los permisos que concediste a la anterior no se conservan. Si una versión nueva no graba ni siquiera después de concederlos, elimina las entradas de OpenScreen en ambos permisos en Ajustes del Sistema, luego vuelve a abrir la app y concédelos de nuevo.
@@ -153,7 +154,7 @@ Las herramientas de edición son las mismas en todas partes: zooms, fondos, encu
153
154
| Flujo de captura | Nativo (ScreenCaptureKit) | Nativo (Windows Graphics Capture) en la compilación 19041 y posteriores; respaldo por navegador en compilaciones anteriores o sin el módulo auxiliar | Nativo (PipeWire mediante el portal ScreenCast); respaldo por navegador sin el módulo auxiliar, con lo que se pierden la codificación por hardware y la telemetría del cursor |
154
155
| Cursor personalizado / efectos de clic | ✅ (los clics y la forma del cursor necesitan el permiso de Accesibilidad) | ✅ | ✅ en Wayland (la captura de clics necesita el grupo `input`, [detalles](#mouse-clicks-on-wayland)) |
155
156
| Cámara web | Captura por navegador, guardada como archivo aparte (sigue funcionando como PiP) | Captura nativa, guardada como archivo aparte | Captura por navegador, guardada como archivo aparte (sigue funcionando como PiP) |
156
-
| Audio del sistema | Funciona sin configurar nada; aviso de permiso en macOS 14.2+ | Funciona sin configurar nada | Necesita PipeWire como servidor de sonido (predeterminado en Ubuntu 22.10+, Fedora 34+) |
157
+
| Audio del sistema | Funciona sin configurar nada; su propio aviso de permiso en macOS 15.2+, cubierto por Grabación de pantalla en versiones anteriores| Funciona sin configurar nada | Necesita PipeWire como servidor de sonido (predeterminado en Ubuntu 22.10+, Fedora 34+) |
157
158
| Exportación MP4 | ✅ | ✅ | ✅: H.264 en la GPU mediante VAAPI cuando la pila gráfica lo permite (consulta la nota más abajo), por software en caso contrario; H.265 solo por software |
158
159
| Exportación GIF | ✅ | ✅ | ✅ |
159
160
| Transcripción en el equipo | Metal (Apple Silicon) / CPU | Vulkan / CPU | Vulkan / CPU |
0 commit comments