Skip to content

Documentation

A quick guide to getting productive with DuckCast. This page is a living document — if something is missing, email [email protected].

On this page

Install

Download DuckCast for macOS. There are separate notarized builds for Apple Silicon and Intel — the Apple menu ▸ About This Mac tells you which chip you have. Open the downloaded app and move it to your Applications folder. DuckCast requires macOS 14 (Sonoma) or later.

Connect your data

DuckCast works with local files and DuckDB databases — nothing is uploaded anywhere. Add a source from the sidebar or drag a file into the window. Supported sources include:

Linked files appear in the sidebar tree alongside their schemas and tables. Select a table to browse its rows in a fast native grid.

Run SQL

Open a SQL tab to write queries against any connected source using DuckDB’s SQL dialect. The editor includes syntax highlighting and formatting. Run the current statement to see results in the grid below; large result sets are handled efficiently. Your query history is kept so you can revisit earlier work.

Ask the AI

Not sure how to phrase a query? Use the AI chat to ask in plain language and get SQL back against your schema. Note that when you send a message, your prompt and the context you include are sent to your configured AI provider — see the Privacy Statement. Everything else stays on your Mac.

Charts & exploration

Turn result sets into charts, and use the visual data explorer to slice through a dataset without writing SQL. This is handy for a quick look before you commit to a query.

Export results

Export any result set to CSV, JSON, Parquet, or Excel for use elsewhere.

Licensing & updates

The free tier gives you one workspace window with up to 3 tabs. A license removes those limits on one Mac. Paste your key into the License screen to activate. DuckCast updates itself automatically via Sparkle — see the changelog for what’s new. For anything else, visit Support.