Skip to main content
TablePro loads database drivers, import/export formats, and themes as .tableplugin bundles. Five driver plugins ship inside the app; the rest download on demand from the plugin registry.

Bundled plugins

These ship with the app, update with app releases, and cannot be uninstalled:

Registry plugins

These install from the registry when you need them:

Installing plugins

You usually don’t install drivers by hand. The database type chooser marks registry drivers you don’t have with a Not Installed badge; pick one anyway and TablePro downloads the plugin before connecting. No restart needed. To browse the full catalog, open Settings > Plugins > Browse. Search, filter by category (Database Drivers, Export Formats, Import Formats, Themes, Other), and click Install.
Plugin registry browser in Settings

Browse and install plugins from the registry

To install from a file, drag a .tableplugin or .zip onto Settings > Plugins > Installed, or click the + button there. User-installed plugins live in ~/Library/Application Support/TablePro/Plugins. Every plugin is verified before it loads: registry downloads must match the SHA-256 checksum in the registry manifest, and the bundle’s code signature must match TablePro’s signing team.

Updates

TablePro compares installed plugin versions against the registry and shows a badge on the Plugins settings tab counting pending updates and plugins that failed to load. Select the plugin under Installed and click Update. If a driver has open connections, the update is staged instead of applied. The staged version activates when the last connection using the driver closes, or click Activate Now after closing them. Quit before it activates and the update is offered again on next launch.

After an app update

An app update can raise the plugin interface version. Plugins built against the old version are rejected at load instead of crashing, and TablePro repairs them on its own: at launch it fetches the registry and reinstalls a compatible build of each outdated plugin, retrying after 30 seconds, then 5 and 10 minutes (up to five attempts), when the registry is unreachable or a download fails. It tries again when the network comes back, and connecting to a database whose plugin is outdated updates that plugin first. Until a plugin is repaired, it appears in a banner in Settings > Plugins > Installed with the reason and an action:

Managing plugins

In Settings > Plugins > Installed:
  • Toggle a plugin off to unload its drivers and formats without deleting it; toggle it back on to reload.
  • Click Uninstall to remove a user-installed plugin from disk. Bundled plugins can’t be uninstalled.
  • The detail pane shows version, bundle ID, capabilities, database type, and default port. Plugins with their own settings show them here.
macOS can’t fully unload a plugin’s code until relaunch, so after removing one a banner offers Quit & Reopen.

Themes

Themes are plugins too: install registry themes from Settings > Plugins > Browse under the Themes category. Choose, create, duplicate, import, and export themes in Settings > Appearance. See Appearance.

Writing plugins

Want to build your own driver, format, or theme? See Plugin Development.