> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-fix-customizable-find-shortcut.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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/import-from-app-picker.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=77ea5e65717fd5149379ce23fa507e4b" 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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/import-from-app-picker-dark.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=e8b32e199ad6eec3980ed2cca31de76a" 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-fix-customizable-find-shortcut/kTCBCR3s8Zf0lJQF/images/connection-import-preview.png?fit=max&auto=format&n=kTCBCR3s8Zf0lJQF&q=85&s=620458d3b0c072a666cec787e69c3233" 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-fix-customizable-find-shortcut/kTCBCR3s8Zf0lJQF/images/connection-import-preview-dark.png?fit=max&auto=format&n=kTCBCR3s8Zf0lJQF&q=85&s=252529205e89c39e5a953f6d0b2dcb5c" 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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/settings-keyboard.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=d4e9ad81e3c1ca7875337e2ddb31f4a7" 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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/settings-keyboard-dark.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=eafe4b98fc6324695c85483119d81dc2" alt="Keyboard settings with the shortcut recorder" width="1444" height="1180" 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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/import-from-url.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=278d1ac3685aa95a415120de219f1dec" 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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/import-from-url-dark.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=cb21fb0e5a5e8039eddfb1c0cfa594fe" 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

<DriverCounts />

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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/settings-plugins-browse.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=931ae7b690ea42e6fe23606477921be6" 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-fix-customizable-find-shortcut/GYIGfx97cTn41Qvn/images/settings-plugins-browse-dark.png?fit=max&auto=format&n=GYIGfx97cTn41Qvn&q=85&s=a6ad641804ac94d5d25e7e3aaa7296b4" 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.
