# Mac app > The Mac app is not published yet. How it will work: drop in a file or a link, pick a mode, add your own key, and export. License and scribiz:// links. Page: https://scribiz.com/docs/apps/mac > [!IMPORTANT] > The Mac app is not published yet. There is no signed build, so there is nothing to download today. This page describes how the app will work. To use Scribiz today, use the [web tool](https://scribiz.com/docs/quickstart.md#web), the [command-line tool](https://scribiz.com/docs/cli.md), the [MCP server](https://scribiz.com/docs/mcp.md) or the [API](https://scribiz.com/docs/api.md). The Mac app is for local files, folders, screen recordings and links. You drop something in, it runs the CLI for you, and the Context shows up in a window with the transcript, the on-screen notes, the summary and the chapters. It needs macOS 14 or later. ## Install Once a signed build is out, the [download page](https://scribiz.com/download) will show the download button. Then: 1. Open the disk image and drag Scribiz to Applications. 2. Open it. Sign in, or add your own Gemini key. See [Sign in or use your own key](#sign-in-or-use-your-own-key). ## Add something Any of these starts a job: - Drop a file or several onto the window. - Drop onto the Scribiz icon in the Dock. - Open the menu bar panel and drop on its drop zone, or paste a link into the field there. - Press **⌘O** and pick a file. - Choose Scribiz in Finder's Open With. - Copy a link, then switch to the app. It offers to use the link from the clipboard. Jobs go into a queue, in the order you added them. Two run at a time by default. Settings has a setting for 1 to 4. ## The window The sidebar has the Queue and the History. Pick a job and the detail pane shows four tabs. | Tab | What it shows | | --- | --- | | Transcript | Paragraphs with speakers and timestamps. Click a word to play from there. | | On screen | Scenes with the text that appeared in each | | Summary | The summary, key points and key moments | | Chapters | The chapters, with their start times | The menu bar panel shows the drop zone, the link field and your last five jobs. ### Export Use the Export menu for SRT, VTT, TXT, Markdown, Context and JSON. There is also Copy for AI, which copies the Context format. Exports are made by the CLI from the saved Context, so they match what `scribiz format` writes. See [Output formats](https://scribiz.com/docs/cli/formats.md). ## Modes Pick Auto, Listen, Watch or Both for each job, or set a default in Settings. They work as described in the [Overview](https://scribiz.com/docs/overview.md#modes). Listen sends only audio. Watch builds a low-resolution copy of the video on your Mac and uploads that. It is opt-in, and the original video is never uploaded. ## Sign in or use your own key Open Settings, then Account. - **Sign in.** The app will sign in through the same code flow as `scribiz login`, which the command-line tool has had since version 0.1.1. The app opens your browser and stores the key it gets in the Keychain. Jobs then use your plan's minutes. - **Your own Gemini key.** Paste it into Settings. It is stored in the Keychain and passed to the CLI through the environment, never as an argument. Jobs run from your Mac to Google and use no Scribiz minutes. Which one wins, and how the minutes work, is on [Authentication](https://scribiz.com/docs/authentication.md) and [Minutes and billing](https://scribiz.com/docs/minutes-and-billing.md). > [!WARNING] > Google may use content sent with a free-tier Gemini key to improve its products. Turn on billing for the key to opt out. ## Links For a link, the app fetches from your own connection, which is why TikTok and Instagram work better here than on the web. This needs `yt-dlp`: ```bash brew install yt-dlp ``` Settings has a field for the path if you installed it somewhere else. For Instagram posts that need a login, the app can use a browser's session. See [Sources and limits](https://scribiz.com/docs/sources-and-limits.md). ## Files The app reads mp4, mov, m4a, mp3, wav and most other common formats itself. For containers macOS cannot open, such as mkv, webm and avi, it uses `ffmpeg` if you have it: ```bash brew install ffmpeg ``` Without it the app says so and points you to the same fix. There is no file size limit. The audio is cut on your Mac, and only the pieces are uploaded. ## Where your data is Each job is a folder under `~/Library/Application Support/Scribiz/jobs/`, with the job's details and the saved Context. Jobs survive a relaunch. A job that was running when you quit is marked as interrupted and can be resumed. Finished work is cached, so resuming is cheap. Delete a job from the History to remove its folder. See [Privacy and data handling](https://scribiz.com/docs/privacy-and-data.md). ## License Mac Lifetime is tied to your account, not to a license key you paste. - Sign in with the account that bought it. The app checks your license and keeps a signed token on the Mac, so it keeps working offline for 30 days. - It covers the app and every 1.x update. - It includes a one-time 300 minutes of hosted use. Past that, use your own Gemini key, which has no limit from Scribiz. The license is bought on Stripe's payment page, once Mac Lifetime is on sale. The [pricing page](https://scribiz.com/pricing) says whether it is. See [Minutes and billing](https://scribiz.com/docs/minutes-and-billing.md#paying). ## Open links in the app `scribiz://open?url=...` opens the app with a link ready to run. The result page on the website uses it for its "Open in Scribiz for Mac" button, and it falls back to the download page if the app is not installed. ```bash open "scribiz://open?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DjNQXAC9IVRw" ``` ## Keyboard | Key | Action | | --- | --- | | ⌘O | Open a file | | ⌘, | Open Settings | --- Written against the Scribiz spec dated 2026-10-04. Check it against the shipped build.