Start here
Bring in from another browser
Move your profiles, spaces, pinned tabs, history and passwords from Arc, Chrome, Dia, Firefox, Zen, Safari and other browsers, or from a bookmarks file.
This page is a first draft. It may change before the public beta.
The migration assistant reads your other browser and previews what comes over before anything changes. It only reads from the source browser and never changes its data.
Open it from Settings → Advanced → Import…, or from Import from Another Browser… in the welcome window.
In the welcome window, the browsers on this Mac sit in a row with a switch for each kind of data under the one you pick, and Bring from imports it. Passwords and sign-ins have a row of their own there with Set Up…, which opens the full assistant with them turned on. Customize… opens the full assistant, with Choose a File… at its top for an Arx archive or a bookmarks file.
Sources
| Source | What Arx reads |
|---|---|
| Arc | Favorites, pinned tabs and folders, and open tabs, from each of your Arc spaces, plus each profile's history and installed extensions. Each new space takes its Arc colors, and Favorites and pinned tabs bring their icons, so they show before their pages load. Easels, notes and welcome tabs aren't imported. |
| Google Chrome | Each profile's bookmarks and history. Every Chrome profile becomes one space. |
| Dia | Each profile's bookmarks and history, the same way as Chrome. |
| Brave, Microsoft Edge, Helium, Chromium, Opera, Opera GX, Vivaldi and Island | The same as Chrome, plus open tabs. |
| Chrome Beta, Dev and Canary, Edge Beta, Dev and Canary, Brave Beta and Nightly | The same as their browser. Each channel is its own source. |
| Firefox | Each profile's bookmarks, with the Bookmarks Toolbar at the top and the other bookmark folders kept, its open tabs and history. |
| Zen | Zen's spaces with their names and icons, Essentials as favorites, pinned tabs and their folders, open tabs and history. |
| Safari | The Favorites bar as favorites, your other bookmarks with their folders, Reading List, tab groups (each becomes a space), the tabs of open windows, Safari profiles, and history. Arx needs Full Disk Access first: see Safari. |
| Arx archive | A file you exported from Arx. See Export and import. |
| Bookmarks HTML | A bookmarks file exported from any browser. |
Arc, Chrome and Dia have been checked against the real browsers. The others follow the same formats and are still being checked; to hide them, run defaults write dev.capturecontext.arx MigrationUncheckedSources -bool NO in Terminal and reopen Arx.
Passwords and sign-ins are one more kind of data for browsers, off until you turn them on, and never go into an Arx archive. See Passwords and sign-ins.
Safari
macOS keeps Safari's bookmarks, tabs and history in a protected folder that only apps with Full Disk Access can read. When you pick Safari, Arx shows Allow Full Disk Access in place of the kinds of data, with Open System Settings:
- Click Open System Settings. It opens Privacy & Security → Full Disk Access.
- Turn on Arx.
- Come back to Arx. It checks again as soon as it's in front and shows Safari's data. If macOS asks to quit and reopen Arx, do that and open the import again.
Arx reads Safari's files only when you import, and changes nothing in Safari. You can turn Full Disk Access off again afterwards in the same place.
In the welcome window, pick Safari, see the Allow Full Disk Access card, click Open System Settings, turn on Arx under Full Disk Access, switch back to Arx, and watch Safari's categories appear.
Choose what comes over
Pick the source, then the kinds of data: Favorites, Bookmarks, Open Tabs, Archived Tabs, History, Extensions, Preferences and, for browsers, Passwords and sign-ins. Click Continue.
History goes into the Arx profile each browser profile maps to, one entry per page at its latest visit. Arx reads a copy of the history file, so you can keep the other browser open.
Start from a clean Arx
Once Arx holds something of yours (a tab, a pinned tab, a Favorite, a folder, an archived tab, or a second profile or space), the full assistant offers Clear Arx Data First under the kinds of data. A brand-new Arx has nothing to clear, so it isn't offered there. It's off until you turn it on. With it on, the import starts from an empty Arx, so each profile of the other browser becomes a fresh Arx profile and nothing mixes with what you set up before.
- Turn on Clear Arx Data First and click Continue.
- Arx asks Remove Everything in Arx? and lists what goes: your profiles by name, how many spaces and tabs, and each profile's saved passwords, sign-ins, history, extensions and site data.
- Click Remove and Continue. Pages that ask before closing, such as a form you haven't sent, ask now; if one says no, nothing is removed.
- Arx shows Clearing Arx…. It makes one new, empty profile and space, and every window switches to it. Then it removes your old profiles one at a time, the way Remove Profile… does in Settings with Permanently erase this profile's website data chosen. You can't close the import meanwhile.
- The review opens against the clean Arx, and the import goes on as usual.
The old profiles disappear from Arx right away. Their website data is erased as for any profile removed that way: Arx finishes after you quit it, and the files are gone after the next restart of your Mac. Until then, Settings → Profiles shows where each one is. This can't be undone. The other browser isn't changed.
If Arx can't clear everything, it says so and imports nothing. What it removed stays removed, the new profile stays, and any profile it didn't get to stays without spaces: remove it from Settings, or turn off Clear Arx Data First and import without it.
In Settings → Advanced → Import… with two profiles in Arx, pick a browser, turn on Clear Arx Data First, click Continue, read the list in Remove Everything in Arx?, click Remove and Continue, watch Clearing Arx… and the window switch to the new empty space, then import.
Extensions from Arc
Arx installs Arc's extensions from the Chrome Web Store for you, one at a time, after the rest of the import. The welcome window's Extensions row and the review say how many come from the store. The others, such as ones you loaded from a folder, are listed by name for you to reinstall yourself.
- After the import, Arx downloads each store extension and shows the usual review: its version, its package and the permissions it asks for, with which extension this is out of how many.
- Click Install to install it into the Arx profile its Arc profile went to, or Cancel to leave it out. Skip All leaves out this one and the rest.
- When they're done, Arx lists each extension as installed, already in Arx, declined, skipped, not from the Chrome Web Store, or couldn't install.
Nothing installs without your click. You can't close the import while a review is waiting; click Skip All to stop. Extensions from an Arx archive are still listed to reinstall by hand.
In the welcome window with Arc selected, see the History and Extensions switches with the count from the Chrome Web Store, click Bring from Arc, install the first extension from its review, cancel the second, and look over the result line.
Map your profiles
Next, under Profiles, every profile of the other browser has a row. Choose where each one goes:
- New profile: a new Arx profile. Its name starts as the other browser's profile name; change it in Name. This is the default when the source has profiles.
- An existing Arx profile: its spaces come in as new spaces there, and its favorites and history join that profile.
Your choices stay if you go back to change the kinds of data. Passwords and sign-ins follow the same mapping: a profile's passwords go into the Arx profile that gets its tabs. A bookmarks file without profiles goes into the current space.
If you import again later, a profile Arx made earlier is reused and keeps its name.
Review, then import
The review marks every item as New, Already imported or Can't import. For Arc it also lists your spaces with their colors. Arx keeps a color as a hue and an intensity, so a space's colors come out close to Arc's rather than exact, and a gradient takes at most three colors. Import runs one category at a time, and you can cancel and retry. Arx never imports the same item twice, so running the assistant again later only adds what's new.
Passwords and sign-ins
Turn on Passwords and sign-ins with the other kinds of data. They follow your profile mapping, so there's nothing more to pick: once the rest of the import is done, each browser profile's passwords go into the Arx profile that got its tabs. This works even with every other kind of data off: Arx still makes the new profiles you mapped. Arx files don't carry passwords, so the switch isn't there for them.
Directly from Arc, Chrome or Dia
With an Arx that can take them, passwords and sign-ins move straight from Arc, Chrome or Dia, without a CSV file. Below the mapping, the review says so and names the key macOS will ask about. Use CSV files instead switches to files.
- After the import, Arx lists each browser profile with its Arx profile and explains that macOS is about to ask whether Arx may use the other browser's key from your keychain (for example "Chrome Safe Storage"). It recommends Allow Once. Skip leaves passwords for later.
- Click Continue. Arx asks for Touch ID or your password, and works only while Arx is in front. macOS asks about the key once for all your profiles.
- For each profile, choose what moves: its saved passwords, and the sites whose sign-ins move, one by one. A site where Arx couldn't read all of its cookies is listed as needing you to sign in again.
- After importing, Arx checks each site and tells you, per profile, which ones kept you signed in and which need you to sign in again, and why. A password Arx already had for that site and username is kept.
- Undo Import removes exactly what that import added in every profile, and nothing that was there before.
A moved sign-in stays signed in in the other browser too, and some sites may sign one of them out. If you choose Deny, or the browser has no key Arx can read, Arx offers CSV files instead and doesn't ask again.
In the migration assistant with Chrome selected, turn on Passwords and sign-ins, map two Chrome profiles, import, read the keychain explanation, choose Allow Once in macOS's prompt, pick a few sites in each profile, import, look over the per-site report, then click Undo Import.
From Firefox, Zen and Safari
- Firefox and Zen keep passwords in the profile's own files, so macOS doesn't ask. If you set a primary password in Firefox or Zen, Arx doesn't ask for it: export your passwords from the browser and import that file instead. Logins for a site's own sign-in prompt (the small username and password dialog, rather than a form on the page) aren't imported; the summary says how many stayed in Firefox or Zen.
- Safari: Arx brings the sites you're signed in to with the Full Disk Access you gave it. Its passwords come from a CSV file, below.
From CSV files
For Safari, other browsers, an Arx that can't take passwords directly yet, or when you'd rather not give Arx the key, import a CSV file of passwords for each browser profile:
- Export the passwords of each profile from the other browser as a CSV file. In Chrome, that's in its Password Manager settings.
- In the review, under Passwords and sign-ins, click Choose… next to each profile and pick its file. Remove takes a file off again.
- Click Import. After the rest of the import, each file goes into the Arx profile its browser profile went to, and Arx tells you, per profile, how many passwords it imported, which ones it kept because that site and username were already saved, and which rows it skipped.
- If a file can't be read, Arx says why next to its profile and keeps it there. Click Import to try again, or Remove it and choose another. The files that went in stay done.
Safari keeps its passwords in the Passwords app, which other apps can't read. For Safari, the review explains how to export them: in the Passwords app, choose File → Export All Passwords…, save the CSV file, then choose it next to the Safari profile it belongs to.
Sign-ins don't move with a CSV file. When you're done, move the CSV files to the Bin: they hold your passwords unencrypted. It's the same import as Import… in the profile's Passwords settings.
Only the migration assistant opens this step. MCP clients and other assistant apps can't reach it.
In the migration assistant with Safari selected, turn on Passwords and sign-ins, click Continue, click Choose… next to a profile, pick an exported CSV, import, and look over the imported, already-saved and skipped counts for that profile.