> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-refactor-inspector-field-layout.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Switching to TablePro

> Move your connections from TablePlus, Sequel Ace, DBeaver, DataGrip, Beekeeper Studio or Navicat, what comes across, what does not, and how to get your shortcuts back

Most of a migration is one dialog. **File > Import from Other App…** reads the connections your current client already has, including groups and folders, and the source app does not need to be running.

This page covers the rest: what does not come across, and what to do about it.

## Import your connections

<Steps>
  <Step title="Open the importer">
    **File > Import from Other App…**
  </Step>

  <Step title="Pick your current client">
    TablePlus, Sequel Ace, DBeaver, DataGrip and Beekeeper Studio are read in place. Navicat is the exception: export first with **File > Export Connections** in Navicat, with **Export Password** turned on, then point TablePro at the `.ncx` file.
  </Step>

  <Step title="Review and import">
    Deselect anything you do not want, resolve duplicates, click **Import**.
  </Step>

  <Step title="Open one before you delete the old app">
    Connect to a connection that had a password. That is the only check that proves the credential came across, and deleting the source app is the one step you cannot undo.
  </Step>
</Steps>

<Frame caption="Pick the client you're coming from">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/import-from-app-picker.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=e8ec7d141966d24626a0fdf23fa11373" alt="Import from other app, source picker" width="1400" height="964" data-path="images/import-from-app-picker.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/import-from-app-picker-dark.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=8f62f3ba3ef7808607645866011b3b2b" alt="Import from other app, source picker" width="1400" height="964" data-path="images/import-from-app-picker-dark.png" />
</Frame>

<Frame caption="Review before anything is saved">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/aX0D3pAvRYSYWiRh/images/connection-import-preview.png?fit=max&auto=format&n=aX0D3pAvRYSYWiRh&q=85&s=7fff48c0790727f950ee9d55d55c9518" alt="Import preview listing the connections found" width="1400" height="900" data-path="images/connection-import-preview.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/aX0D3pAvRYSYWiRh/images/connection-import-preview-dark.png?fit=max&auto=format&n=aX0D3pAvRYSYWiRh&q=85&s=0527e852cc74b2d19002b4c161499dd8" alt="Import preview listing the connections found" width="1400" height="900" data-path="images/connection-import-preview-dark.png" />
</Frame>

SSH tunnel and SSL settings come across with the connection. Which engines each source carries, and the quirks of each one, are in [Connection Sharing](/features/connection-sharing).

## About passwords

| Where your old client keeps them                            | What the import does                                                                                        |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Its own encrypted store: DBeaver, Beekeeper Studio, Navicat | Decrypts it and runs start to finish with nothing to click                                                  |
| The macOS Keychain: TablePlus, Sequel Ace, DataGrip         | macOS asks permission once per item. Choose **Always Allow** rather than **Allow** and the run stops asking |

A DataGrip project protected by a master password cannot be read at all. Import those connections and set their passwords in TablePro.

## What does not come across

| Not imported                                    | What to do                                                                                                                                                                                                                                                     |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Saved queries and snippets                      | Re-save the ones you actually use as [Favorites](/features/favorites) with `Cmd+D`. To keep a whole folder of `.sql` files in sync instead, including one tracked in git, [Linked Folders](/features/connection-sharing) does that and needs a Starter license |
| Query history                                   | Starts fresh. TablePro records history per connection from the first query you run, searchable with `Cmd+Y`                                                                                                                                                    |
| Column widths, sort order and per-table filters | Rebuilt as you browse. TablePro saves these per table on its own                                                                                                                                                                                               |
| Keyboard shortcuts                              | See the next section                                                                                                                                                                                                                                           |

## Getting your shortcuts back

TablePro follows macOS conventions, so a good number of chords already match whatever you were using: `Cmd+N`, `Cmd+W`, `Cmd+S`, `Cmd+O`, `Cmd+Q`, `Cmd+F`, and `Cmd+Enter` to run a query.

Where yours differ, rebind them in **Settings > Keyboard** (`Cmd+,`). Record the chord you are used to and TablePro warns you if something else already claims it.

<Frame caption="Settings > Keyboard, where every rebindable shortcut lives">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/settings-keyboard.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=4bfa23e4a5fee1e8825e54657f774419" alt="Keyboard settings with the shortcut recorder" width="1442" height="1178" data-path="images/settings-keyboard.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/settings-keyboard-dark.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=efd1b9fa92b93da266f2b6c58f734147" alt="Keyboard settings with the shortcut recorder" width="1442" height="1178" data-path="images/settings-keyboard-dark.png" />
</Frame>

Set these up on your first day:

| Job                                                | TablePro          |
| -------------------------------------------------- | ----------------- |
| Run the statement under the cursor                 | `Cmd+Enter`       |
| Run every statement                                | `Cmd+Shift+Enter` |
| Jump to any table, database or saved query by name | `Cmd+Shift+O`     |
| Switch database                                    | `Cmd+K`           |
| Query history                                      | `Cmd+Y`           |
| Cancel a running query                             | `Cmd+.`           |
| Format the query                                   | `Cmd+Shift+L`     |
| Explain the query                                  | `Cmd+Option+E`    |
| Save the query as a favorite                       | `Cmd+D`           |

A few cannot be reassigned, so learn them rather than fight them: editor built-ins such as `Cmd+/` for comment, `Cmd+[` and `Cmd+]` for indent, tab selection `Cmd+1` through `Cmd+9`, and text size `Cmd+=` and `Cmd+-`. The recorder tells you when you hit one.

Coming from TablePlus, where `Cmd+F` opens the row filter? Rebind **Toggle Filters** to `Cmd+F` in **Settings > Keyboard** and choose **Reassign** when it asks. Find gives up `Cmd+F` while the filter bar holds it, and takes it back if you move the filter bar off again.

If you use Vim bindings, turn on [Vim Mode](/features/vim-mode) in **Settings > Editor** and most of this section stops mattering.

The full list is in [Keyboard Shortcuts](/features/keyboard-shortcuts).

## Coming from a client TablePro cannot import

Two other routes exist.

**A connection URL.** **Add from Existing > Import from URL** takes a `postgres://`, `mysql://` or similar URL and fills in the form. Fastest path when you only have a handful of connections.

<Frame caption="Import from URL">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/import-from-url.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=10d50c5da0cef0657afcbe9e23b0cc52" alt="Import a connection from a database URL" width="1400" height="964" data-path="images/import-from-url.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/import-from-url-dark.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=8a29650617e7f6f4acf0e5a3b55c32d7" alt="Import a connection from a database URL" width="1400" height="964" data-path="images/import-from-url-dark.png" />
</Frame>

**A project folder.** [Open Project Folder](/features/project-folder-import) reads the database settings out of a project's config files, so a repository with a `.env`, `docker-compose.yml` or framework config becomes a connection without you typing a host.

## If your database is not supported yet

Five drivers ship inside the app and cover nine databases. Nineteen registry plugins cover the
other twenty-one and install on the first connection that needs one. See
[Plugins & Themes](/features/plugins).

A database missing from the connection form may still be one click away in **Settings > Plugins > Browse**.

<Frame caption="Settings > Plugins > Browse">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/settings-plugins-browse.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=af9aa60ba595e68a30d991f71ab722f3" alt="Plugin registry browser" width="1442" height="1178" data-path="images/settings-plugins-browse.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-refactor-inspector-field-layout/dVn-gILXlhQ7lA6L/images/settings-plugins-browse-dark.png?fit=max&auto=format&n=dVn-gILXlhQ7lA6L&q=85&s=45fbdb0b2c5032a2976a1fd5dae0b286" alt="Plugin registry browser" width="1444" height="1180" data-path="images/settings-plugins-browse-dark.png" />
</Frame>

If it is genuinely not there, open a request on [GitHub](https://github.com/TableProApp/TablePro/issues). Driver coverage is tracked in the open, and the [supported database list](/connections) is the current answer.
