Start here

Settings

What's in each Settings pane, and how appearance works per profile and per space.

This page is a first draft. It may change before the public beta.

Open Settings with ⌘,. The sidebar has a search at the top, so you can type the name of a setting instead of hunting for it; the categories scroll under it. It finds settings inside the panes too, and pages and sheets such as AI Commands, Proxy Links, Air Traffic Control and Local assistants (MCP), by name or by a related word ("MCP", "alias", "bangs"). Each result shows where the setting lives, such as Advanced › Local assistants (MCP). Click one, or move with ↑ and ↓ and press ↩: Settings opens the pane, scrolls to the setting and highlights it for a moment, or opens its page or sheet. The command bar finds the same settings from any window, with whether a switch is on. Each pane opens with a large icon and title; as you scroll, they move into the left of the bar at the top with the pane's description under the title, and the settings blur out softly under the bar, with no line beneath it. The bar sits level with the sidebar's search, clear of the window's top edge. A pane's own search, such as Shortcuts', is a magnifier button on the right of the bar: click it or press ⌘F and it opens into a wide search field. It stays open while it holds text; clear it or press Esc and it folds back. A list that grows as you use Arx, such as Proxy Links, Search Shortcuts or Air Traffic Control's routes, has a page of its own. In its pane it's one row with a count on the right, such as 3 rules, and a chevron; click it, or press ↩ or → when you've moved to it with the keyboard. A page inside a pane, such as Assistant › AI Commands, Links › Proxy Links or a profile's page, has a bar with a Back button, the page's title and, under it, the pane it's in; ⌘[ goes back too, and so does ← unless you're typing in a field. Sheets, such as Preview Settings or a profile's Passwords, have the same bar with a Close button (×) and the way you came, such as Profiles › Work; Esc closes them too. A sheet's own buttons and search sit on the right of its bar, and its content scrolls under the bar, blurring out softly beneath it.

Each pane is a grouped list: a heading, the settings on a rounded card, and a note under the card when there's something to explain. Switches sit on the right of their row. Text you can type in, such as a rule's name, is a rounded field with its name above the value and a pencil on the right; the field gets a colored ring while you type.

Sheets that ask you for something, such as a Links rule or a site's permission, end the same way: Cancel with esc, and the action, such as Save, with ↩ in your accent color, or in red when it removes something. A new profile, renaming or removing a profile or space, and Clear Browsing Data have the bar with Close (×) instead, which esc also presses, and their action, such as Create or Clear Data, alone at the bottom. The action stays grey until what you've typed is complete. Rows that open a page or sheet, such as a profile or Site Settings, are highlighted under the pointer and darken as you click.

PaneWhat's there
ArxYour Arx identity card, which you can share as an image, and whether Arx is your default browser
GeneralUpdates and the update channel (see Updates), Warn before quitting, Open the site from its notification, Allow Handoff, Previews on hover, Unload inactive tabs, where new tabs open and where tabs from links open, switching to tabs links open, unread badges, Content blocking, Picture in Picture, Battery Saver, Autofill, Search shortcuts, the setup guide
ProfilesProfiles, each with its search engine and suggestions, automatic archiving, full URL, appearance, downloads folder, history, extensions, passwords, addresses and cards, site settings and clearing browsing data
AssistantEach profile's default provider and model for chats and how long chats stay, what Return does in the chat's message box, then the providers Arx is connected to. See Chat with the assistant.
LinksProxy Links, Little Arx, Peek and link clicks, Air Traffic Control and App Links
ShortcutsEvery command with its alias and its key. See Keyboard shortcuts.
Appearance & SoundTheme (System, Light or Dark), window background (tint and film grain), the sidebar's side, Sound feedback, Application icon
PrivacyThe crash reports kept on this Mac, and Report a Problem…. See Crash reports and problem reports.
DeveloperDeveloper mode. See Developer mode.
AdvancedLocal assistants (MCP), Restore previous windows at launch, Haptic feedback, WebKit (sites that open in WebKit pages), Memory, Feature Flags, Import…, Export Bookmarks…, Export Archive…

Appearance

Settings → Appearance & Sound → Theme sets every Arx window to System (the default, following your Mac's light or dark appearance), Light or Dark. Each choice shows a small Arx window in your current window background; the selected one has a colored ring.

Profiles and spaces can choose their own theme, and the narrower one wins:

  • Per profile, in Settings → Profiles: Theme and Film grain.
  • Per space, from the space's menu → Appearance.

Each is Default, which follows the level above, or a fixed choice: Light or Dark for the theme, On or Off for film grain.

Window background

Settings → Appearance & Sound → Window background colors the sidebar and window frame. Page content stays clear. A strip at the top shows the result, grain and light or dark included, as you change it.

SettingDefault
TintLavender, one of nine colors
IntensityFrom grey (the dot on the left) to the full color (the dot on the right)
Match siteOff
Film grainOn
Amount0.18, from 0 to 1, shown while film grain is on
Size1, from 1 to 3 in quarter steps, shown while film grain is on

Reset to Default appears once something differs, and puts it back. A profile or space shows Inherited beside a setting it takes from above, or Inherit to go back to that once it has its own; Use Global Appearance or Use Profile Appearance clears all of its own choices.

Gradients for profiles and spaces

A profile's or space's Appearance can also choose Colors: one keeps the tint's own soft gradient, and two or three add colors to it. Pick a hue for each added color and an Angle for the gradient's direction. The strip at the top, and the window while you drag, show it as you go. One color in a space keeps the plain gradient even when its profile has more.

Accent color

Accent color sets the color Arx draws its own highlights in: folder icons in the sidebar, focus rings, the selected command, drop targets and unread badges. It's in three places, and the most specific choice wins:

  • Settings → Appearance & Sound → Window background: Automatic, the default, takes the accent from the tint, so the default lavender keeps Arx's usual indigo and an orange tint gets an orange accent. Or pick one of the colors, or any color with the color well.
  • Per profile, in Settings → Profiles, and per space, from the space's menu → Appearance: Inherited until you pick a color. Inherit goes back to the level above.

Arx checks each accent against the sidebar behind it and darkens it on a light sidebar, or brightens it on a dark one, just enough to stand out, so a pale yellow still reads. With Match site on, the accent stays the one you chose while the sidebar follows the page.

The accent color is being tested and is on in the beta. To turn it off, turn off its feature flag in Settings → Advanced → Feature Flags and relaunch Arx, or quit Arx and run:

defaults write dev.capturecontext.arx ARX_ACCENT_COLOR -string off

To turn it back on, turn the flag back on in the same place, or quit Arx and run:

defaults delete dev.capturecontext.arx ARX_ACCENT_COLOR
Recording planned

With ARX_ACCENT_COLOR on, open Settings → Appearance & Sound and choose a red accent: the sidebar's folders turn red. In a profile's settings choose green, then in a space's Appearance choose teal: that space's folders are teal, the profile's other spaces green. Click Inherit in the space: its folders turn green again.

Unread badges

Settings → General → Tabs → Unread badges lists the sites whose badges you've hidden, each with Show. See Unread badges.

Close with Delete when empty

Settings → General → Close with Delete when empty is on by default. Pressing Delete in an empty command bar or address field closes it, as Esc does. In a site search, the first Delete leaves the search. See Keys.

Autofill

Settings → General → Autofill → Ask before filling passwords is on by default. Picking a saved account in a sign-in form asks for Touch ID or your Mac password before Arx fills it. See Filling.

Fill addresses and Fill payment cards below it are on by default. Turn one off and Arx stops offering saved addresses or cards in forms. A card always asks for Touch ID first. See Addresses and cards.

Haptic feedback

Settings → Advanced → Haptic feedback is on by default. On a Force Touch trackpad you feel a tick each time a tab you're dragging in the sidebar would land somewhere new, and a tap when Force Click opens a link in Peek or Little Arx.

WebKit

Settings → Advanced → WebKit has the switch, and WebKit sites under it opens the list of sites that open in WebKit pages, where protected video and music play. See Netflix, Spotify and protected video.

Memory

Settings → Advanced → Memory gathers what Arx keeps in memory:

SettingDefaultWhat it does
Unload inactive tabsAfter 6 hoursHow long a hidden tab keeps its page before Arx unloads it. The same setting as in General → Tabs.
When memory runs lowAfter 1 minuteWhen your Mac runs critically low on memory, hidden tabs unload once they've been hidden this long, from After 30 seconds to After 10 minutes, sooner than Unload inactive tabs says. A tab you leave and come straight back to stays loaded.
Keep pinned tabs loadedOffPinned tabs and Favorites never unload.
Sites kept loadedNoneSites whose tabs never unload, even when memory runs low. The row shows how many and opens their own page, where Add Site… opens a form: type a site, such as music.example.com or example.com (which covers its subdomains), and with more than one profile choose which profile it's for, since each keeps its own sites. Click a listed site to change it or its profile in the same form. Remove stops keeping one. Always Keep This Site Loaded in a tab's menu adds and removes them too.
Pages kept for Back and Forward3 pagesHow many pages you've left each tab keeps ready, so ⌘[ and ⌘] show them at once, scrolled where you were. Off, or 1 to 6 pages. More pages use more memory. Arx reads this when it opens, so a change applies after you quit and reopen it; the row says so until then.

See Unloaded tabs.

Feature Flags

Settings → Advanced → Feature Flags lists features that are still being tested, each with a switch. A row says what the feature does and gives its ARX_… name. In the beta, every flag starts on.

  • A change takes effect after a relaunch. Each row says so. After you change one, Some changes take effect after Arx relaunches appears at the top of the page with a Relaunch button; click it to quit and reopen Arx.
  • Some carry a warning. iCloud sync warns that deletions may sync between Macs, and SQLite workspace that it changes where Arx keeps your workspace, so export an archive first.
  • The environment wins. Each name also works as an environment variable, such as ARX_READING_MODE=0 when you open Arx from Terminal. A flag set that way shows a lock and Set by ARX_… in the environment, and its switch can't change until Arx is opened without it.

Assistants can't turn feature flags on or off.

Per-profile settings

Each profile in Settings → Profiles has its own:

SettingDefaultWhat it does
Search suggestionsOnSends what you type in the command bar to your profile's search engine for suggestions, where supported. See Command bar.
Automatically archive tabsNeverMoves unpinned tabs you haven't looked at for 12 hours, 1 day, 7 days or 30 days to the Tab Archive.
Show the full URL in the toolbarOffShows the whole address in the address bar instead of the site's name. Editing always shows the whole address.
Site SettingsAsk; pop-ups blocked; 100% zoomWhat each site may use, and page zoom. See Site settings.
Downloads: Save files toYour Downloads folderWhere downloads go. See Downloads.
Ask where to save each fileOffShows a save panel before each download.
Clear browsing dataRemoves history, downloads list, cookies, cache, autofill or site settings for a time range. See Clear browsing data.
Turn on Show the full URL in the toolbar, and the address bar shows the whole address. Turn it off, and it shows the site's name again.
Planned
Settings still to come: sounds for Sound feedback to play, and more app icons.