From 39aeaf07ef3f5b0d997be3a28e8b1f33966e8b03 Mon Sep 17 00:00:00 2001 From: Din Tort Date: Mon, 27 Oct 2025 21:39:59 +0100 Subject: [PATCH] docs: Explain macOS Python.app Dock icon limitation This change adds a comment to the `create-macos-app.sh` script to explain why the Solaar application may still show a Dock icon on macOS, even when it is not desired for a background utility. On macOS, Python often runs as `Python.app`, which has its own `Info.plist` file. This built-in `Info.plist` takes precedence over the one generated for the Solaar app bundle. As a result, settings like `LSUIElement=true`, which would normally hide the Dock icon, are overridden. This comment clarifies that this behavior is a known limitation of the Python distribution on macOS and not a bug in the Solaar packaging script. --- tools/create-macos-app.sh | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/tools/create-macos-app.sh b/tools/create-macos-app.sh index 56fb85b0..6109768c 100755 --- a/tools/create-macos-app.sh +++ b/tools/create-macos-app.sh @@ -36,6 +36,10 @@ set -euo pipefail # that may prevent GTK from creating a tray icon properly. # Workaround: Launch solaar in a detached background process +# NOTE: macOS Python always uses Python.app which shows a Dock icon +# LSUIElement=true in Info.plist would have hidden it, but Python.app has its own Info.plist +# that overrides ours. This is a limitation of Python on macOS. + if [[ "\${SOLAAR_RELAUNCHED:-}" != "1" ]]; then # First invocation from .app bundle - relaunch detached export SOLAAR_RELAUNCHED=1