Mac app guide
Scribeberry Computer.
It does the clicking.
It works in your EMR and any other app on your Mac: opens the chart, types the note, files the fax. Anything risky, like saving, sending or billing, waits for your yes.
What it does
Brief it the way you'd brief a new MOA: which app to use, what “done” looks like, and any patients or dates that matter. It finds the window, clicks and types until that job is finished. There is nothing to wire up per EMR: if you can do it on your Mac, it can try.
As it works, it checks items off in Scribeberry so you can see progress even if you stop halfway.
- Runs on
- Your Mac, from the menu bar
- AI
- Scribeberry AI, with cloud processing in Canada
- Voice
- Scribeberry Live transcription
- Dictate anywhere
- Hold ⌥ Space to type by voice into any field; words appear live in the bar
- Approvals
- Pauses before risky steps: send, delete, bill, or anything you cannot undo
- Whole computer
- Uses your screen, mouse, and keyboard in any app you have open
- Browser only
- Works in its own Chrome profile and leaves your mouse and keyboard alone
Install and sign in
Plan on about a minute. You sign in in the browser, so you never type your Scribeberry password into the Mac app.
- Download Scribeberry Computer, drag it to Applications, and open it. It lives in the menu bar.
- Click Sign in with Scribeberry. Your browser opens Connect Scribeberry Computer.
- Check that the email on the page is yours, then click Connect this Mac.
- When the page says Connected, return to the Mac app. You are signed in.
- Only approve sign-in if you started it from the app yourself.
- If the app says Computer use is not enabled, ask your admin or Scribeberry support to turn it on for your account.
Allow macOS permissions
The first time you run a task, macOS asks for three permissions. Without them, the app cannot see the screen or control the keyboard.
- Screen Recording
- So it can read what is on screen
- Accessibility
- So it can move the mouse, click, and type
- Microphone
- So you can talk instead of typing
- Open System Settings, then Privacy & Security.
- Under Screen Recording, Accessibility, and Microphone, turn on Scribeberry Computer.
- If macOS asks you to quit and reopen the app, do that.
- Later, open the Mac app's Settings → Permissions. Each item shows Granted, or a Grant or Fix button that opens the right switch.
Your first five minutes
You are not left on a blank screen. A short setup guide on the web walks you through install and permissions, then continues inside the Mac app. Most people finish in about two minutes.
- Watch what it does. Short demos, then Start setup.
- Get the app. Download, drag to Applications, open. The guide notices when this Mac checks in.
- Connect. Sign in in the browser, then allow Screen Recording, Accessibility, and Microphone in the Mac app (Settings → Permissions).
- Run one small job. With a chart open, tap a ready-made job like Summarize this chart and watch it get checked off.
- Optional: turn that job into a scheduled routine, or skip.
- On the Mac, the same guide confirms who you are signed in as and checks permissions before your first real task.
- Closed halfway through? On the web, open Computer use and click Show me. On the Mac: Settings → Account → Replay setup guide.
- On a shared Mac, sign in as yourself first. Threads and browser sessions stay separate per account.
Choose Background or Take over
Pick this once per Mac under Settings → Mode. New installs default to Take over. The web app never changes this for you.
- Background
- A dedicated Chrome window and profile. Your mouse, keyboard, and everyday Chrome stay yours. Good for EMR and portal work you repeat daily.
- Take over
- Your real screen and any desktop app. Good when the chart is already open in your EMR client. Press ⌘ ⇧ S to take control back.
- Needs your screen
- If a Background task can only finish on your actual desktop, it pauses and asks. Click Take over to continue.
- Open the Mac app → Settings → Mode.
- Choose Background or Take over.
- For Background: Settings → Browser profile → Open in Chrome. Sign in to your EMR and portals there once. That profile keeps its own cookies, separate from your personal Chrome.
- Send a task. The floating bar says Working in background or Controlling your screen so you always know which mode is active.
- You cannot switch mode while a task is running. Stop with ⌘ ⇧ S first.
- Each routine saves its own mode, so one job can run in Background even if your day-to-day setting is Take over.
Give it a task
Open the prompt bar (menu bar or ⌘ ⇧ Space), or hold a talk shortcut and speak. Name the app and say what finished looks like. Plain language is fine.
- Example: chart work
- In Epic, finish the H&P for Maya Robinson's follow-up. The chart is open.
- Example: inbox
- Reply to this referral letter in Outlook and attach today's consult note.
- Tasks
- Do my open tasks in my EMR. It's open in Chrome.
- Notes
- Enter today's notes into the matching patient charts.
- Faxes
- File the new faxes and make a task for anything abnormal.
- Billing
- Enter today's day sheet into the billing portal.
- Pre-charting
- Pull tomorrow's schedule from my EMR and pre-chart everyone.
- Long lists are handled one item at a time. Each finished item is recorded in Scribeberry before it moves on.
Enter today's notes into the matching patient charts- ⌘ ⇧ Space
- Open the prompt bar from anywhere
- ⌥ Space
- Hold to dictate into any app, release to insert
- ⌘ ⇧ H
- Screenshot + Ask
- ⌃ ⇧ C
- Talk, with a screenshot
- ⌃ ⇧ B
- Talk
- Enter / Esc
- Allow or deny when an approval card is showing
- ⌘ ⇧ S
- Stop the run from anywhere
- ⌘ ⇧ Q
- Quit Scribeberry Computer
Dictate into any app
You do not need a task running. Click a field, hold ⌥ Space, talk, release. Words stream live in the bar at the bottom of the screen (Scribeberry Live), then paste into the field you clicked.
- Shortcut
- Hold ⌥ Space, release to insert. Push-to-talk: nothing records while you are not holding it
- Paste into focused app
- Settings → System dictation. Needs Accessibility. If off, dictation still copies every result to the clipboard
- Turn it off
- Settings → System dictation → Hold ⌥Space anywhere. A quick press while off shows a message instead of failing silently
- In the composer
- The microphone in the prompt bar works the same for task requests: hold, talk, edit the text, then send
- Click the field you want, anywhere on your Mac.
- Hold ⌥ Space. The bar at the bottom shows Listening.
- Talk. New words stay visible as you speak.
- Release ⌥ Space. The bar shows Inserted and the text lands in that field.
- If the app blocks paste, the bar says Copied to clipboard. Press ⌘ V yourself.
- A very quick tap is ignored so an accidental press does not leave the mic open.
- Microphone permission is required to hear you. Accessibility is required to paste into other apps.
Approve risky actions
You choose how cautious the Mac app is under Settings → Approvals. Default is Smart approval: reads and navigation go ahead; send, delete, bill, and other hard-to-undo steps pause on a card. If the cloud review cannot run, it asks you instead of guessing.
- Smart approval (default)
- Runs safe reads; asks before risky or unclear actions
- Auto
- Never asks. Only use on a Mac and account you trust to run unattended
- Ask every action
- Asks before any write or patient-data touch, even small ones
- Read the card: plain-language summary plus tags like Patient data, Billing, or Can't be undone.
- Press Enter or Allow to run that one step only. The next risky step will ask again.
- Press Esc or Deny to block it. The denial is logged and is not retried behind your back.
- Change the policy anytime under Settings → Approvals.
- Approvals are per action, not per task. A fax-and-file workflow might ask more than once.
- Allowed and denied steps appear in the thread for later review.
- Scheduled routines wait on the card if nobody is at the Mac. Plan for that before you automate send or delete.
Watch it work and take back control
While a task runs, the floating bar stays visible, the thread lists each finished step, and Take over mode tints the screen edges so you know something else is driving.
- Floating bar
- Shows mode and status. Drag it, or hide it under Settings → Floating bar. ⌘ ⇧ Space brings the prompt bar back
- Stop
- ⌘ ⇧ S anywhere, or Stop in the bar. Closes a pending approval and ends the run
- Needs your screen
- Background run that needs your desktop pauses with a card. Take over or Later
- Screenshot + Ask
- ⌘ ⇧ H to ask about what's on screen; ⌃ ⇧ C or ⌃ ⇧ B for voice with or without a screenshot
- Steps already marked done in Scribeberry stay done if you stop early. Send the same request again to finish the rest.
Send work from Scribeberry
Buttons across the web app package the request for you: the right records attached, a suggested prompt you can edit, then Send to my Mac.
- Click the button (for example Do with Computer on Tasks). Scribeberry shows what it will send.
- Edit the request if you want, then Send to my Mac.
- Watch the status: Waiting for your Mac → Running on your Mac → Finished. View conversation opens the full thread.
| Where | Button | What it does |
|---|---|---|
| Tasks | Do with Computer | Works your open tasks in the app on screen and checks each one off. |
| Note toolbar | Hand off to Computer | Puts the note in the patient chart and marks it entered. |
| Scribes, several selected | Hand off to Computer | Enters each note in its chart. Creates a task if a chart is missing. |
| Fax inbox and fax detail | Do with Computer | Files faxes into charts and creates follow-up tasks. |
| Billing day sheet | Enter with Computer | Enters each line in your billing system and marks it in Scribeberry. |
| Patient facts | Sync with Computer | Updates demographics and IDs from the chart on screen. |
| Pre-chart | From my screen (Computer) | Imports the day's schedule from your EMR and pre-charts each patient. |
| Receptionist inbox | Do with Computer | Books or handles requests in your scheduling system. |
| Ask Scribeberry | /computer | Type /computer plus your request, e.g. /computer file this fax into Maya Robinson's chart. |
| Clinical Workflows | Do with Computer step | Add the step; the workflow hands that part to your Mac. |
- If the Mac app is closed, the request waits and starts when you open it and sign in.
Check the results
You can verify work in Scribeberry without reopening the EMR or portal.
- Tasks
- Checked off. Activity on the task explains what the Mac app did.
- Notes
- Marked entered. The toolbar shows a check and which app was used.
- Faxes
- Marked filed. Exceptions become new tasks.
- Billing
- Lines marked entered, or rejected with a reason.
- Patients
- Demographics and chart IDs updated from what was on screen.
- Anything it cannot finish stays open with a note, or becomes a task for you.
Automate with routines
A routine is a saved prompt on a schedule. Test it once on your Mac, then let it run on weekdays, daily, or every few hours.
- Computer use → Routines → New routine (same list under Mac Settings → Routines).
- Name it and describe the job like you would in chat. Pick Whole computer or Browser only.
- Start test run. Your Mac picks it up within about a minute. Read the thread.
- If it matched what you wanted, Looks good, schedule it.
- Set days, time, time zone, and turn on Run on schedule.
- The Mac app must be open and signed in. A missed window is marked Missed because your Mac was offline.
- Changing the prompt or mode requires a new test run before the next scheduled run.
- Run now fires immediately. Run history lists every attempt with its conversation.
- Approvals apply to routines too. A nightly file-and-send job needs someone at the Mac when it hits a risky step.
Review threads on the web
Every run saves a thread under Computer use in the sidebar. Open one to see what it tried, what you approved, and what it marked done.
Screenshots from the run stay on your Mac and are not uploaded to the web.
Settings on your Mac
Behaviour lives on the Mac only. The web app sends work and shows threads; it does not override Mac settings.
- Routines
- Same routines as Computer use on the web: test, schedule, run now, history
- Mode
- Background Chrome vs Take over your screen. Saved on this Mac
- Approvals
- Smart approval, Auto, or Ask every action
- Shared workstation
- Asks before every action, clears the clipboard after dictation, and signs out after 10 minutes idle
- Floating bar
- Show, hide, or drag the bar that follows a run
- System dictation
- ⌥ Space everywhere; paste into focused app or clipboard only
- Permissions
- Accessibility, Screen Recording, Microphone, with Grant or Fix links
- Browser profile
- Chrome profile for Background mode: open, sign in once, reset if needed
- Shortcuts
- Global shortcuts: prompt bar, dictation, voice, screenshot, stop
- Account
- Signed-in Scribeberry account and Sign out for this Mac
Manage your Macs
Scribeberry → Settings → Connected Macs lists every Mac signed in with your account and when each was last active.
- Find the machine. The one you are on is labeled This Mac.
- Click Sign out and confirm. That Mac stops until someone signs in again; routines will not run there.
- Signing out of the web app does not sign out Macs. You can also sign out under Mac Settings → Account.
Troubleshooting
- Status stays on Waiting for your Mac
- Open Scribeberry Computer on your Mac and confirm you are signed in. Web requests start as soon as the app is open.
- It cannot see the screen, or cannot click
- Screen Recording or Accessibility is off. Mac app → Settings → Permissions → Fix.
- It does not hear you
- Allow Microphone in System Settings → Privacy & Security, then try the talk shortcut again.
- Holding ⌥ Space does nothing
- Update or restart the app. Check Settings → System dictation: Hold ⌥Space anywhere should be on. If the bar shows but nothing pastes, grant Accessibility; text still copies without it.
- Dictated words arrive all at once, or the end is cut off
- Hold ⌥ Space briefly before you speak so the stream connects. Keep holding through the last word, then release to insert.
- A run is paused and nothing moves
- Look for an approval card above the prompt bar, or Needs your screen. Enter allows one step, Esc denies, Take over hands it your desktop.
- Too many approvals, or none at all
- Mac app → Settings → Approvals. Smart approval is the default balance; Auto never asks; Ask every action asks before writes.
- It is using your mouse and you need it back
- ⌘ ⇧ S to stop. For repeat browser work, switch Settings → Mode to Background so it uses its own Chrome.
- Routine shows Missed because your Mac was offline
- The app was closed or the Mac slept at run time. Keep it open during the window, or Run now.
- It stopped partway through a list
- Open the thread for the last completed item. Finished rows are already in Scribeberry; send the request again for the remainder.
Questions
Which apps does Scribeberry Computer work with?
Any app or website on your Mac. It reads the screen and uses the UI the way you would. There are no per-vendor integrations to install.
What happens to my data?
Requests go through Scribeberry servers to Scribeberry AI, with cloud processing in Canada. The Mac app stores only its sign-in session, not API keys. Threads sync to your account without screenshots; screenshots stay on the Mac. Delete any thread from Computer use on the web.
Does it need my EMR password?
No. It uses apps you are already signed into. In Browser only mode, sign in once in Settings → Browser profile → Open in Chrome.
Can I stop it?
Yes. ⌘ ⇧ S at any time, or Cancel run on a request in Scribeberry.
Does it ask before it sends, deletes, or bills?
By default, yes. Smart approval pauses before risky or unclear actions. You allow or deny one step at a time with Enter and Esc. Change the policy under Mac Settings → Approvals.
Can I dictate into my EMR without running a task?
Yes. Click a field, hold ⌥ Space, talk, release. Text inserts or copies to the clipboard. Toggle under Settings → System dictation.
What is the difference between Background and Take over?
Background uses a dedicated Chrome profile and leaves your controls alone. Take over uses your whole screen and desktop apps. Background tasks that need the desktop pause and ask you to take over.
Where are Computer's settings?
On the Mac only: mode, approvals, floating bar, dictation, permissions, browser profile, shortcuts, routines, and account. The web app sends work and shows threads; it does not change Mac settings.
Do routines run when my Mac is asleep or the app is closed?
No. Routines need the Mac app open and signed in. Missed runs are skipped; web requests wait until you open the app.
Does it work on Windows?
Scribeberry Computer is Mac-only. Scribeberry web, desktop, and mobile work on other platforms.
How do I remove a Mac I no longer use?
Settings → Connected Macs → Sign out next to that Mac → confirm.

Sign in to Scribeberry Computer