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
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,9 @@ On first launch, open **System Settings > Privacy & Security** and grant the two
> [!NOTE]
> **Upgrading from a version older than 1.9.0?** 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 the new version won't record even after you grant them, remove OpenScreen's existing entries under **System Settings > Privacy & Security** (both Screen Recording and Accessibility), then launch it again and grant them when prompted.

> [!NOTE]
> **OpenScreen quits as soon as you pick what to record, or when the countdown starts?** It is most likely a utility that quits apps once their last window closes, such as the **Quit on close** option of [Vorssaint](https://github.com/vorssaint/vorssaint-utils). It does not count OpenScreen's recording bar, which floats above other windows, so it quits OpenScreen whenever the bar hides or a source window closes. Add OpenScreen to that utility's exceptions, or turn the option off. The [FAQ](https://getopenscreen.com/docs/faq#why-does-openscreen-quit-on-macos-when-i-choose-what-to-record) shows how to check which app asked OpenScreen to quit.

### Windows

**Recommended — Microsoft Store**
Expand Down
17 changes: 17 additions & 0 deletions website/docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,22 @@ On Windows and macOS, the native recorders write fragmented MP4 in one-second fr

Bug reports and feature requests go to [GitHub issues](https://github.com/getopenscreen/openscreen/issues).

## Why does OpenScreen quit on macOS when I choose what to record?

**Most likely, another app asks it to quit.** Some Mac utilities quit an app as soon as they decide its last window has closed. One example is the **Quit on close** option of [Vorssaint](https://github.com/vorssaint/vorssaint-utils), when it is turned on. It does not count the HUD, OpenScreen's recording bar, as a window, because the HUD floats above other windows. It then quits OpenScreen a second or two after either of these:

- On macOS 15.2 and later, the HUD hides while Apple's system picker is open.
- Before macOS 15.2, OpenScreen's own source window closes once you pick, so the app can disappear during the countdown.

OpenScreen closes as it does with ⌘Q: no error message and no crash report.

- **To fix it**, add OpenScreen to the utility's exceptions, or turn the option off. In Vorssaint: **Quit on close**, **Exceptions**, **Add app…**.
- **To see which app asked**, run this in Terminal right after OpenScreen closes. On each line, the name after the time is an app that sent a quit request:

```sh
/usr/bin/log show --last 5m --info --style compact --predicate 'eventMessage CONTAINS "AESendMessage(aevt,quit"'
```

## What doesn't OpenScreen do?

If you need any of these, OpenScreen is not the right tool:
Expand All @@ -130,5 +146,6 @@ Checked September 2026:
- Original repository and its archive notice: [github.com/siddharthvaddem/openscreen](https://github.com/siddharthvaddem/openscreen)
- Official Homebrew tap: [github.com/getopenscreen/homebrew-openscreen](https://github.com/getopenscreen/homebrew-openscreen)
- Open Screen: [openscreen.io](https://openscreen.io/)
- Vorssaint's *Quit on close* option, checked October 2026: [github.com/vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)

Open Screen, Loom, OBS Studio and the other product names on this page are trademarks of their respective owners. OpenScreen is not affiliated with Open Screen (openscreen.io), Loom or OBS Studio.
17 changes: 17 additions & 0 deletions website/i18n/de/docusaurus-plugin-content-docs/current/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,22 @@ Unter Windows und macOS schreiben die nativen Rekorder fragmentiertes MP4 in Fra

Fehlerberichte und Feature-Wünsche gehören in die [GitHub-Issues](https://github.com/getopenscreen/openscreen/issues).

## Warum beendet sich OpenScreen unter macOS, wenn ich auswähle, was ich aufnehmen will? {#why-does-openscreen-quit-on-macos-when-i-choose-what-to-record}

**Meist fordert eine andere App OpenScreen zum Beenden auf.** Manche Mac-Tools beenden eine App, sobald sie annehmen, dass ihr letztes Fenster geschlossen wurde. Ein Beispiel ist die Option **Quit on close** von [Vorssaint](https://github.com/vorssaint/vorssaint-utils), wenn sie eingeschaltet ist. Sie zählt das HUD, die Aufnahmeleiste von OpenScreen, nicht als Fenster, weil das HUD über den anderen Fenstern schwebt. Deshalb beendet sie OpenScreen ein bis zwei Sekunden nach einem dieser Momente:

- Unter macOS 15.2 und neuer ist das HUD ausgeblendet, solange die Systemauswahl von Apple offen ist.
- Vor macOS 15.2 schließt sich das Quellenfenster von OpenScreen, sobald du gewählt hast, sodass die App während des Countdowns verschwinden kann.

OpenScreen beendet sich wie mit ⌘Q: ohne Fehlermeldung und ohne Absturzbericht.

- **Abhilfe:** Füge OpenScreen zu den Ausnahmen des Tools hinzu oder schalte die Option aus. In Vorssaint: **Quit on close**, **Exceptions**, **Add app…**.
- **Um zu sehen, welche App das verlangt hat**, führe direkt nach dem Beenden von OpenScreen diesen Befehl im Terminal aus. In jeder Zeile ist der Name nach der Uhrzeit eine App, die eine Beenden-Anfrage gesendet hat:

```sh
/usr/bin/log show --last 5m --info --style compact --predicate 'eventMessage CONTAINS "AESendMessage(aevt,quit"'
```

## Was kann OpenScreen nicht? {#what-doesnt-openscreen-do}

Wenn du eines davon brauchst, ist OpenScreen nicht das richtige Werkzeug:
Expand All @@ -130,5 +146,6 @@ Geprüft im September 2026:
- Ursprüngliches Repository und sein Archivhinweis: [github.com/siddharthvaddem/openscreen](https://github.com/siddharthvaddem/openscreen)
- Offizieller Homebrew-Tap: [github.com/getopenscreen/homebrew-openscreen](https://github.com/getopenscreen/homebrew-openscreen)
- Open Screen: [openscreen.io](https://openscreen.io/)
- Option *Quit on close* von Vorssaint, geprüft im Oktober 2026: [github.com/vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)

Open Screen, Loom, OBS Studio und die anderen Produktnamen auf dieser Seite sind Marken ihrer jeweiligen Inhaber. OpenScreen steht in keiner Verbindung zu Open Screen (openscreen.io), Loom oder OBS Studio.
17 changes: 17 additions & 0 deletions website/i18n/es/docusaurus-plugin-content-docs/current/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,22 @@ En Windows y macOS, los grabadores nativos escriben MP4 fragmentado, en fragment

Los errores y las solicitudes de funciones se reportan en [GitHub Issues](https://github.com/getopenscreen/openscreen/issues).

## ¿Por qué OpenScreen se cierra en macOS cuando elijo qué grabar? {#why-does-openscreen-quit-on-macos-when-i-choose-what-to-record}

**Lo más probable es que otra aplicación le pida que se cierre.** Algunas utilidades para Mac cierran una aplicación en cuanto deciden que su última ventana se ha cerrado. Un ejemplo es la opción **Quit on close** de [Vorssaint](https://github.com/vorssaint/vorssaint-utils), cuando está activada. No cuenta el HUD, la barra de grabación de OpenScreen, como una ventana, porque el HUD flota por encima de las demás ventanas. Entonces cierra OpenScreen uno o dos segundos después de cualquiera de estos momentos:

- En macOS 15.2 y posteriores, el HUD se oculta mientras el selector del sistema de Apple está abierto.
- Antes de macOS 15.2, la ventana de selección de fuente de OpenScreen se cierra en cuanto eliges, así que la aplicación puede desaparecer durante la cuenta regresiva.

OpenScreen se cierra igual que con ⌘Q: sin mensaje de error ni informe de fallo.

- **Para solucionarlo**, añade OpenScreen a las excepciones de la utilidad o desactiva la opción. En Vorssaint: **Quit on close**, **Exceptions**, **Add app…**.
- **Para ver qué aplicación lo pidió**, ejecuta esto en Terminal justo después de que OpenScreen se cierre. En cada línea, el nombre que sigue a la hora es el de una aplicación que envió una petición de cierre:

```sh
/usr/bin/log show --last 5m --info --style compact --predicate 'eventMessage CONTAINS "AESendMessage(aevt,quit"'
```

## ¿Qué no hace OpenScreen? {#what-doesnt-openscreen-do}

Si necesitas algo de esto, OpenScreen no es la herramienta adecuada:
Expand All @@ -130,5 +146,6 @@ Verificadas en septiembre de 2026:
- Repositorio original y su aviso de archivo: [github.com/siddharthvaddem/openscreen](https://github.com/siddharthvaddem/openscreen)
- Tap oficial de Homebrew: [github.com/getopenscreen/homebrew-openscreen](https://github.com/getopenscreen/homebrew-openscreen)
- Open Screen: [openscreen.io](https://openscreen.io/)
- Opción *Quit on close* de Vorssaint, verificada en octubre de 2026: [github.com/vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)

Open Screen, Loom, OBS Studio y los demás nombres de productos de esta página son marcas comerciales de sus respectivos propietarios. OpenScreen no está afiliado a Open Screen (openscreen.io), Loom ni OBS Studio.
17 changes: 17 additions & 0 deletions website/i18n/fr/docusaurus-plugin-content-docs/current/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,22 @@ Sous Windows et macOS, les enregistreurs natifs écrivent un MP4 fragmenté, par

Les signalements de bugs et les demandes de fonctionnalités vont dans les [tickets GitHub](https://github.com/getopenscreen/openscreen/issues).

## Pourquoi OpenScreen se ferme-t-il sous macOS quand je choisis quoi enregistrer ? {#why-does-openscreen-quit-on-macos-when-i-choose-what-to-record}

**Le plus souvent, une autre application lui demande de quitter.** Certains utilitaires pour Mac quittent une application dès qu'ils estiment que sa dernière fenêtre est fermée. C'est le cas de l'option **Quit on close** de [Vorssaint](https://github.com/vorssaint/vorssaint-utils), quand elle est activée. Elle ne compte pas le HUD, la barre d'enregistrement d'OpenScreen, comme une fenêtre, parce que le HUD flotte au-dessus des autres fenêtres. Elle quitte alors OpenScreen une ou deux secondes après l'un de ces moments :

- Sous macOS 15.2 et ultérieur, le HUD se masque pendant que le sélecteur du système d'Apple est ouvert.
- Avant macOS 15.2, la fenêtre de choix de source d'OpenScreen se ferme une fois votre choix fait : l'application peut donc disparaître pendant le compte à rebours.

OpenScreen se ferme comme avec ⌘Q : sans message d'erreur ni rapport de plantage.

- **Pour corriger**, ajoutez OpenScreen aux exceptions de l'utilitaire, ou désactivez l'option. Dans Vorssaint : **Quit on close**, **Exceptions**, **Add app…**.
- **Pour savoir quelle application l'a demandé**, lancez ceci dans le Terminal juste après la fermeture d'OpenScreen. Sur chaque ligne, le nom qui suit l'heure est celui d'une application qui a envoyé une demande de fermeture :

```sh
/usr/bin/log show --last 5m --info --style compact --predicate 'eventMessage CONTAINS "AESendMessage(aevt,quit"'
```

## Que ne fait pas OpenScreen ? {#what-doesnt-openscreen-do}

Si vous avez besoin de l'une de ces fonctions, OpenScreen n'est pas le bon outil :
Expand All @@ -130,5 +146,6 @@ Vérifiées en septembre 2026 :
- Dépôt d'origine et son avis d'archivage : [github.com/siddharthvaddem/openscreen](https://github.com/siddharthvaddem/openscreen)
- Tap Homebrew officiel : [github.com/getopenscreen/homebrew-openscreen](https://github.com/getopenscreen/homebrew-openscreen)
- Open Screen : [openscreen.io](https://openscreen.io/)
- Option *Quit on close* de Vorssaint, vérifiée en octobre 2026 : [github.com/vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)

Open Screen, Loom, OBS Studio et les autres noms de produits cités sur cette page sont des marques de leurs propriétaires respectifs. OpenScreen n'est affilié ni à Open Screen (openscreen.io), ni à Loom, ni à OBS Studio.
17 changes: 17 additions & 0 deletions website/i18n/ja/docusaurus-plugin-content-docs/current/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,22 @@ Windows と macOS では、ネイティブのレコーダーが 1 秒単位の

バグの報告や機能のリクエストは [GitHub の Issue](https://github.com/getopenscreen/openscreen/issues) にお寄せください。

## macOS で録画する対象を選ぶと OpenScreen が終了するのはなぜですか? {#why-does-openscreen-quit-on-macos-when-i-choose-what-to-record}

**多くの場合、別のアプリが OpenScreen に終了を求めています。** Mac のユーティリティの中には、アプリの最後のウィンドウが閉じたと判断した時点で、そのアプリを終了させるものがあります。たとえば [Vorssaint](https://github.com/vorssaint/vorssaint-utils) の **Quit on close** オプションを有効にしている場合です。このオプションは、OpenScreen の録画バーである HUD をウィンドウとして数えません。HUD がほかのウィンドウの上に浮かんでいるためです。そのため、次のいずれかの 1〜2 秒後に OpenScreen を終了させます。

- macOS 15.2 以降では、Apple のシステムピッカーが開いている間、HUD が隠れます。
- macOS 15.2 より前では、選択した時点で OpenScreen のソース選択ウィンドウが閉じます。そのため、カウントダウン中にアプリが消えることがあります。

OpenScreen は ⌘Q のときと同じように終了するため、エラーメッセージもクラッシュレポートも出ません。

- **解決するには**、ユーティリティの例外に OpenScreen を追加するか、オプションをオフにします。Vorssaint では **Quit on close**、**Exceptions**、**Add app…** の順に進みます。
- **どのアプリが終了を求めたかを確かめるには**、OpenScreen が終了した直後にターミナルで次のコマンドを実行します。各行で時刻の後に表示される名前が、終了要求を送ったアプリです。

```sh
/usr/bin/log show --last 5m --info --style compact --predicate 'eventMessage CONTAINS "AESendMessage(aevt,quit"'
```

## OpenScreen にできないことは? {#what-doesnt-openscreen-do}

次のいずれかが必要な場合、OpenScreen は適したツールではありません。
Expand All @@ -130,5 +146,6 @@ Windows と macOS では、ネイティブのレコーダーが 1 秒単位の
- 元のリポジトリとそのアーカイブの告知:[github.com/siddharthvaddem/openscreen](https://github.com/siddharthvaddem/openscreen)
- 公式の Homebrew tap:[github.com/getopenscreen/homebrew-openscreen](https://github.com/getopenscreen/homebrew-openscreen)
- Open Screen:[openscreen.io](https://openscreen.io/)
- Vorssaint の *Quit on close* オプション(2026 年 10 月に確認):[github.com/vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)

Open Screen、Loom、OBS Studio、およびこのページに記載のその他の製品名は、各所有者の商標です。OpenScreen は、Open Screen(openscreen.io)、Loom、OBS Studio のいずれとも提携していません。
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,22 @@ No Windows e no macOS, os gravadores nativos escrevem MP4 fragmentado, em fragme

Os relatos de bugs e os pedidos de recursos vão para as [issues do GitHub](https://github.com/getopenscreen/openscreen/issues).

## Por que o OpenScreen fecha no macOS quando escolho o que gravar? {#why-does-openscreen-quit-on-macos-when-i-choose-what-to-record}

**O mais provável é que outro app peça para ele encerrar.** Alguns utilitários para Mac encerram um app assim que concluem que a última janela dele foi fechada. Um exemplo é a opção **Encerrar ao fechar** do [Vorssaint](https://github.com/vorssaint/vorssaint-utils), quando está ativada. Ela não conta o HUD, a barra de gravação do OpenScreen, como uma janela, porque o HUD flutua acima das outras janelas. Então ela encerra o OpenScreen um ou dois segundos depois de um destes momentos:

- No macOS 15.2 e posterior, o HUD fica oculto enquanto o seletor do sistema da Apple está aberto.
- Antes do macOS 15.2, a janela de escolha de fonte do OpenScreen fecha assim que você escolhe, então o app pode sumir durante a contagem regressiva.

O OpenScreen fecha como com ⌘Q: sem mensagem de erro e sem relatório de falha.

- **Para resolver**, adicione o OpenScreen às exceções do utilitário ou desative a opção. No Vorssaint: **Encerrar ao fechar**, **Exceções**, **Adicionar app…**.
- **Para ver qual app pediu**, execute isto no Terminal logo depois que o OpenScreen fechar. Em cada linha, o nome que vem depois da hora é o de um app que enviou um pedido para encerrar:

```sh
/usr/bin/log show --last 5m --info --style compact --predicate 'eventMessage CONTAINS "AESendMessage(aevt,quit"'
```

## O que o OpenScreen não faz? {#what-doesnt-openscreen-do}

Se você precisa de algum destes itens, o OpenScreen não é a ferramenta certa:
Expand All @@ -130,5 +146,6 @@ Verificadas em setembro de 2026:
- Repositório original e seu aviso de arquivamento: [github.com/siddharthvaddem/openscreen](https://github.com/siddharthvaddem/openscreen)
- Tap oficial do Homebrew: [github.com/getopenscreen/homebrew-openscreen](https://github.com/getopenscreen/homebrew-openscreen)
- Open Screen: [openscreen.io](https://openscreen.io/)
- Opção *Encerrar ao fechar* do Vorssaint, verificada em outubro de 2026: [github.com/vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)

Open Screen, Loom, OBS Studio e os demais nomes de produtos nesta página são marcas de seus respectivos proprietários. O OpenScreen não tem vínculo com o Open Screen (openscreen.io), o Loom nem o OBS Studio.
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,22 @@ OpenScreen 是一款免费的录屏与视频剪辑软件,采用 MIT 许可证

错误报告和功能请求请提交到 [GitHub issues](https://github.com/getopenscreen/openscreen/issues)。

## 为什么在 macOS 上选择要录制的内容时,OpenScreen 会退出? {#why-does-openscreen-quit-on-macos-when-i-choose-what-to-record}

**多半是另一个应用让它退出的。** 有些 Mac 工具一旦认定某个应用的最后一个窗口已经关闭,就会让该应用退出。例如开启后的 [Vorssaint](https://github.com/vorssaint/vorssaint-utils) **Quit on close** 选项。它不会把 OpenScreen 的录制栏 HUD 算作窗口,因为 HUD 浮在其他窗口之上。于是,在下面任一情况发生后一两秒,它就会让 OpenScreen 退出:

- 在 macOS 15.2 及更高版本上,Apple 的系统选择器打开期间,HUD 会隐藏。
- 在 macOS 15.2 之前,选好之后,OpenScreen 自己的来源选择窗口会关闭,因此应用可能在倒计时期间消失。

OpenScreen 的退出方式与按下 ⌘Q 相同:没有错误提示,也没有崩溃报告。

- **解决方法**:把 OpenScreen 加入该工具的例外列表,或关闭这个选项。在 Vorssaint 中依次进入 **Quit on close**、**Exceptions**、**Add app…**。
- **要查看是哪个应用发出的请求**,请在 OpenScreen 退出后立即在终端中运行下面的命令。每一行中,时间后面的名称就是发出退出请求的应用:

```sh
/usr/bin/log show --last 5m --info --style compact --predicate 'eventMessage CONTAINS "AESendMessage(aevt,quit"'
```

## OpenScreen 不能做什么? {#what-doesnt-openscreen-do}

如果你需要以下任何一项,OpenScreen 并不是合适的工具:
Expand All @@ -130,5 +146,6 @@ OpenScreen 是一款免费的录屏与视频剪辑软件,采用 MIT 许可证
- 原始仓库及其归档声明:[github.com/siddharthvaddem/openscreen](https://github.com/siddharthvaddem/openscreen)
- 官方 Homebrew tap:[github.com/getopenscreen/homebrew-openscreen](https://github.com/getopenscreen/homebrew-openscreen)
- Open Screen:[openscreen.io](https://openscreen.io/)
- Vorssaint 的 *Quit on close* 选项(核查于 2026 年 10 月):[github.com/vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)

Open Screen、Loom、OBS Studio 以及本页提及的其他产品名称,均为其各自所有者的商标。OpenScreen 与 Open Screen(openscreen.io)、Loom 或 OBS Studio 均无关联。
Loading
Loading