PATH Contents > General Information
Preferences

This document explains the different settings available in the Preferences window of Unexpectedly.


General

This pane lets you choose whether the registers window should be visible at the launch of the application, which application should be used to open source files or which application should be the default one at the system level to open .crash report files.

Preferences - General

To show or hide the Registers window when you open the Unexpectedly application:

1Choose Unexpectedly > Preferences…
2Click General.
3Check or uncheck the "Show Registers window" checkbox.

To change the application to use to open local source files found by the symbolication process:

1Choose Unexpectedly > Preferences…
2Click General.
3Choose the application you wish to use using the "Open source files with:" popup button.

To change the default application used by the system to open .crash report files:

1Choose Unexpectedly > Preferences…
2Click General.
3Choose the application you wish to use using the "Default report viewer:" popup button.

Presentation

This pane lets you define which components of a stack frame should be visible in reports.

It also lets you choose whether to show line numbers, wrap text or which sections should be visible by default in text reports.

Preferences - Presentation

To show or hide line numbers in text reports:

1Choose Unexpectedly > Preferences…
2Click Presentation
3Click Text.
4Check or uncheck the Line numbers checkbox.

To change the line wrapping style of text reports:

1Choose Unexpectedly > Preferences…
2Click Presentation
3Click Text.
4Check or uncheck the Wrap lines to viewer width checkbox.

To set which sections should be visible by default:

1Choose Unexpectedly > Preferences…
2Click Presentation
3Click Text.
4Check or uncheck the default visible sections.

To set which components of a stack frame should be visible by default:

1Choose Unexpectedly > Preferences…
2Click Presentation
3Click Text or Report.
4Check or uncheck the default visible stack frame components.

To temporarily show or hide sections or stack frame components of a report, use the sections filter or presentation toggles of the report contents view.



Fonts & Colors

This pane lets you select the current theme to use for textual reports, manage the themes and edit them.

Preferences - Fonts & Colors

A theme influences the appearance of text reports by defining which font and color should be used for each type of data, and which background and selection colors should be used.

To use a theme:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
3Select the theme you wish to use.

To edit a theme:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
3Select the theme you wish edit.
4Select the type of data you wish whose appearance should be edited.
5Click the [ T ] button or the color well to edit the appearance of the data.

To rename a theme:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
3Select the theme you wish to use as a template.
4Click the theme name.
5Type the new name and validate with the Return key.

To create a new theme:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
3Select the theme you wish to use as a template.
4Click Duplicate.

To remove a theme:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
3Select the theme you wish to use delete.
4Choose Edit > Delete or click the - button.
5Click Remove.

To export a theme:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
3Select the theme you wish to export.
4Control-click the theme.
5Choose Export Theme…
6Choose the name and location and click Export.

To import a theme:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
4Control-click a theme.
5Choose Import Theme…
6Select a theme file and click Import.

Note: Theme files use the .unexpectedly-theme extension.


To restore the list of default themes:

1Choose Unexpectedly > Preferences…
2Click Fonts & Colors.
3Click Restore Defaults


Symbolication

This pane lets you select whether Unexpectedly should try to resolve the symbols in the backtraces of reports and whether it should automatically look for the appropriate symbol files (.dSYM).

You can also manually add or remove symbol files from the list.

Preferences - Symbolication

To enable or disable the resolution of symbols:

1Choose Unexpectedly > Preferences…
2Click Symbolication.
3Check or uncheck the "Convert machine instruction addresses to symbols when possible" box.

To enable or disable the automatic search of symbol files:

1Choose Unexpectedly > Preferences…
2Click Symbolication.
3Check or uncheck the "Look for symbols files automatically" box.

To manually add symbol files:

1Choose Unexpectedly > Preferences…
2Click Symbolication.
3Click the + button.
4Choose one or more symbol files.
4Click the Add button.

To remove a symbol file:

1Choose Unexpectedly > Preferences…
2Click Symbolication.
3Select the symbol file you wish to remove.
4Click the - button.


Crash Reporter

This pane lets you define if or when the "Unexpectedly Quit" dialog is displayed. It provides the same settings as the CrashReporterPrefs.app application which is part of the Additional Developer Tools (1).

Preferences - Crash Reporter
There are 3 possible operation modes for macOS Crash Reporter:

Operation ModeBehavior
BasicThe Unexpectedly Quit dialog is only displayed for any application run by the user that crashed.
DeveloperThe Unexpectedly Quit dialog is displayed for any process (application or background) run by the user that crashed.
ServerThe Unexpectedly Quit dialog is never displayed.


There are 2 possible notification modes for macOS Crash Reporter:

Notification ModeBehavior
Alert DialogWhen an application quits unexpectedly, an alert window is displayed in the center of the main screen inviting you to report the issue to Apple.
System NotificationWhen an application quits unexpectedly, a system notification is displayed. If you click the notification, an alert window is displayed in the center of the main screen inviting you to report the issue to Apple.


To change the operation mode of macOS Crash Reporter:

1Choose Unexpectedly > Preferences…
2Click Crash Reporter.
3Choose the mode from the "Operation Mode" radio buttons.

To change the notification mode of macOS Crash Reporter:

1Choose Unexpectedly > Preferences…
2Click Crash Reporter.
3Choose the mode from the "Notification Mode" radio buttons.

To also report uncaught exceptions:

1Choose Unexpectedly > Preferences…
2Click Crash Reporter.
3Check the "Report uncaught exceptions" checkbox.

Advanced

This panes lets you define whether Unexpectedly should automatically look for updates or whether the Debug menu should be visible or not.

Preferences - Advanced
By default, Unexpectedly automatically for updates every 3 days. If an update is available, Unexpectedly will announce it to you at the launch of the application. You can choose to download the update, skip it or ask to be reminded later.

To enable or disable the automatic update checks:

1Choose Unexpectedly > Preferences…
2Click Advanced.
3Check or uncheck the "Check automatically for updates" box.

To show or hide the Debug menu:

1Choose Unexpectedly > Preferences…
2Click Advanced.
3Check or uncheck the "Show Debug menu in menu bar" box.



(1) which means that you probably didn't know this application existed in the first place.


Revision History
07/06/21 Add documentation for Advanced pane.
04/11/21 First version

Copyright 2021 Stéphane Sudre. All rights reserved.