Reference

Settings & shortcuts

Customize document display, query preferences, tool paths and workspace restoration.

Open Settings

Choose Settings from the top-right application menu. Changes apply immediately and are saved on this device. Sections are arranged in tabs; use Left/Right arrows or Home/End while a tab is focused.

Appearance and document display

  • Appearance: UI font size, result font size, row density and BSON type badges.
  • Documents: the default Immediate save behaviour, quote markers, natural/alphabetical property order, object summary templates, date format and relative times.
  • Value colours: per-BSON-type colour overrides using hex values or preset swatches.

Object summary templates can show the field count and literal top-level fields:

{$fieldCount} fields {Name} ({_id})

Names are case-sensitive. In this template, dots are literal characters rather than nested paths; missing values are omitted. This differs from a relation's dotted display-property path. These presentation settings do not change database values.

Query and notification preferences

Queries selects enabled filter modes, the default for new editors and the maximum result size per query. Keep at least one filter mode enabled. A new result-size limit applies to queries run after the change; each tab keeps its own results in memory.

Notifications sets the toast position and a timeout between 1 and 60 seconds. Hovering or focusing a notification pauses its countdown. Save confirmations are temporary; query/editor status continues to report conflicts or uncertain outcomes.

Configure external tools

Under Tools, set an executable name on PATH or a full executable path, without arguments:

These tools are installed separately. Document JSON/CSV transfers use Palryn's own implementation and do not need them.

What Remember saves

Workspace → Remember workspace state controls local restoration of workspaces and their drafts. Turning it off clears saved workspace state while retaining the current session in memory.

Saved with RememberNot saved in workspace state
Workspace names, connection memberships and visibility filters.Database results and execution errors.
Query filters, sort/projection, tabs and layouts.Unsaved document and insertion drafts.
Aggregation drafts, Shell scripts and relation definitions.Connection credentials, which use the OS keychain separately.

Workspace storage is local and not encrypted. Query literals and Shell scripts may contain values you entered. On restoration, selecting the active workspace can connect using saved profiles, but queries and scripts require an explicit run.

Updates and release notes

Updates controls automatic update checking. Click the version in the status area to open release information and available update actions. Installation requires choosing Install and restart; checking does not install an update automatically.

With automatic checks enabled, Palryn checks shortly after startup and periodically afterwards, sending its version, operating system and architecture to the update service.

Keyboard reference

ActionShortcut
Run the current query, pipeline or Shell script from its editorCtrl/Command + Enter
Request query suggestionsCtrl/Command + Space
Accept a selected query suggestionTab
Next / previous tabCtrl/Command + Alt + Right / Left
Close a tabCtrl/Command + Alt + W
Switch editor groupCtrl/Command + Alt + Down
Open the focused item's context menuShift + F10 or Context Menu key
Move through menu itemsUp / Down, Home / End
Enter / leave a submenuRight / Left
Cancel inline value inputEscape

Reset preferences

Reset display defaults restores display, query, notification and update preferences. It retains workspace state, Immediate save behaviour and tool paths. Backup tool paths have their own reset action in Tools.

Palryn · Explore your data.
These guides describe the current development build. Available controls may differ in older builds.