Skip to main content

Appearance and notifications

Choose a comfortable theme, set your interface language and receive task alerts while you work in another app. Open Settings → General to adjust these preferences. Open-Science remembers your appearance choices on this device.

Platform
Your choice is kept across chapters.

Change theme and interface language

  1. In General → Appearance, find Theme.
  2. Choose System to follow your device, or select Light or Dark to keep a fixed appearance. You can switch back at any time.
  3. Under Language, choose your preferred interface language, or System to use the device language.

General appearance settings

ChoiceWhat changes
Theme → SystemThe app follows the device's light/dark setting.
Theme → Light / DarkThe selected theme stays fixed when the system theme changes.
Language → SystemThe app reads the device language at startup. After changing the system language, reopen the app to apply it.
A specific languageThe app uses that interface language. Saved prompts, source files and earlier model answers keep their original text.

Language and theme preferences are in Settings → General → Appearance. The documentation website has its own language selector; changing it leaves the app's language unchanged. System file dialogs follow your operating-system settings.

To request a report in a different language, specify that in your conversation. For example: “Write the report in English and preserve the original gene identifiers.”

Set up task notifications

Enable alerts if you want to leave a running analysis and return when it needs attention.

  1. In General → Notifications, turn on Task notifications.
  2. Choose whether to enable Show task content in system notifications. Leave it off if task names or request details should stay out of system alerts.
  3. Read System notification status, then select Send test notification if available. Allow notifications in the operating system when prompted.
  4. Check the returned test status and your system's notification surface. For task alerts, switch to another app while the task runs.
Task notification controls and the reported test status
English app screenshot · Select the image to view it in full
ControlEffect
Task notificationsEnables alerts for task completion, failure or an approval request while you are using another app. Turn it off to stop these task alerts.
Show task content in system notificationsIncludes task names and request details when enabled. Provider errors remain hidden. This control is disabled when Task notifications is off.
System notification statusIndicates whether this device supports system notifications.
Send test notificationSends a test request. The button shows Sending test… during the request and is disabled while sending or when system notifications are unavailable.
A delivered task notificationSelect it to bring Open-Science forward and open the associated task.

Canceled tasks and failures that the app retries automatically stay silent. Messages in Home or the workspace is an in-app entry; OS notification permission is managed separately.

Return to a task from a system alert

Select a completion or approval alert to return to its conversation. If you missed the banner, find Open-Science in macOS Notification Center. Expand a grouped stack first, then select the specific alert. An approval alert opens the task; read and resolve the request inside the app.

English system completion alert with task details hidden

Turn Show task content in system notifications off to use generic alerts. Select a completion or approval alert to reopen its conversation; respond to approvals inside the app.

If a notification does not appear

Start with the test result, then check the condition that applies.

Result or symptomWhat to check next
Test notification shown.The app reports that the test appeared. Check the OS notification surface; a test alert is separate from a real task event.
Test notification sent, but display could not be confirmed.Check system notification permission and whether the OS suppresses banners. Delivery has not been confirmed.
Test notification failed.Check the app's notification permission in system settings, then retry the test. If it still fails, collect the error through Troubleshooting.
System notifications are unavailable on this device.The test control is unavailable. Monitor the task in the workspace.
Test works, but a task sends no alertConfirm Task notifications is on, you are using another app, and the event is completion, failure or an approval request. Cancellations and automatic retries do not alert.
No alert while recording, sharing or mirroringCheck whether the system allows alerts during recording or sharing, and check Focus or Do not disturb. Enable this only when you intend alerts to be visible; they may appear in the recording.
Alert arrives without task detailsCheck Show task content in system notifications. Keep it off if you prefer to hide those details.
You want to…Where to go
Check for an app updateGeneral → About → Check now; follow Installation and updates.
Read version changes or get helpAbout → Release notes / Help Center opens the corresponding external page. This wiki also has a Changelog.
Locate or open the diagnostic logGeneral → Diagnostics → Reveal / Open; see Troubleshooting. Logs stay local until you share them.
Install the command-line entryGeneral → Install command; see CLI reference. Desktop use does not require this command.
Manage data location or archived workStorage and archived work.

Notification settings in the operating system

Notification delivery also depends on the operating system's permissions, Focus mode and screen-sharing settings. Use the checks above on the device where you work.

Source: General settings.