Skip to content

installation.mdx

Latest commit

 

History

History
66 lines (50 loc) · 2.75 KB

installation.mdx

File metadata and controls

66 lines (50 loc) · 2.75 KB
Raw
title Installation
description Install TablePro via Homebrew or DMG on macOS 13.0+

Homebrew is the short route: brew install --cask tablepro picks the build that matches your Mac. Everyone else takes the DMG, and that is the one route where you match the architecture yourself.

System requirements

  • macOS: 13.0 (Ventura) or later
  • Architecture: Apple Silicon (M1 or later) or Intel x86_64

Native Apple frameworks only, so there is no Java or .NET runtime to install first. The download is about 20 MB.

Homebrew

brew install --cask tablepro    # install
brew upgrade tablepro           # update
brew uninstall tablepro         # remove the app
brew uninstall --zap tablepro   # remove the app and its data

The DMG

Release assets carry the version and the architecture: `TablePro--arm64.dmg` and `TablePro--x86_64.dmg`. Check which you need under **Apple menu > About This Mac**, where Chip means Apple Silicon and Processor means Intel. Both are on [GitHub Releases](https://github.com/TableProApp/TablePro/releases). Open the DMG and drag **TablePro** onto the **Applications** shortcut. 
<Frame caption="Drag TablePro to Applications">
  <img
    className="block dark:hidden"
    src="/images/install-dmg.png"
    alt="Drag to Applications"
  />
  <img
    className="hidden dark:block"
    src="/images/install-dmg-dark.png"
    alt="Drag to Applications"
  />
</Frame>
Right-click the mounted disk and choose **Eject**. Open **TablePro** from the Applications folder.

Updates

New versions download in the background and install when you quit TablePro. Force a check with TablePro > Check for Updates…, which always offers the newest build. Two switches in Settings > General turn the daily check and the automatic install off. Connections and settings survive an update.

Removing it

Quit TablePro and drag it from the Applications folder to the Trash. To take the local data with it, which is connections, query history, and any driver plugins you installed:

rm -rf ~/Library/Application\ Support/TablePro
rm ~/Library/Preferences/com.TablePro.plist

Connection passwords are in the macOS Keychain and survive both commands. Delete them in Keychain Access by searching for com.TablePro. Data already synced through iCloud stays in your iCloud account.

Building from source is in CONTRIBUTING.md. A launch that fails or a connection that will not open is in Troubleshooting.