Better PowerScribe 360 AutoHotkey Controls

I’ve been happily using AutoHotkey as a radiologist for years. My scripts are basically simple, mostly human-made artifacts for getting a limited number of specific things done, like using keyboard shortcuts in PowerScribe to replicate the PowerMic buttons with my Contour Shuttle.

For some users on some workstations, the toggling keyboard shortcut method I described in my 2023 AutoHotkey post is laggy and occasionally unreliable (when compared to the buttons on the PowerMic).

The following script, shared with me by radiologist Jon Brandon is a great example of what is possible with AI. He stated he was able to vibe-code an AHK script that (after about 60 tries from ChatGPT) replicates the actual PowerMic buttons themselves as opposed to toggling the active program and entering the keyboard shortcuts.

I tried it, and it worked for me. I’ve never personally really had big issues with script lag, but I know it’s been a big frustration for others.

If it doesn’t work for you (or you use PSOne, for example), upload it to your AI tool of choice and start iterating. The bottom line is that if there is software you want in order to make your life better, it’s now often possible to make it.

You can download the AHK file here.

This gray box is the README (just for background).

# README PowerScribe 360 AutoHotkey Internal Bridge

## What this is

This is a standalone AutoHotkey v2 script for controlling **PowerScribe 360**.

Normal PowerScribe keyboard shortcuts can be slower or less consistent than the
buttons on a PowerMic. This script takes a different approach: instead of
pretending to press PowerScribe shortcut keys, it asks PowerScribe to run its
own internal commands.

There is no PACS automation, mouse configuration, ChatGPT integration, or
personal workflow code in this package.

## Requirements

- Windows
- PowerScribe 360 (this was developed against a 32-bit PowerScribe 360 build)
- AutoHotkey v2
- The 32-bit AutoHotkey executable must be installed. If the script starts
  under 64-bit AutoHotkey, it automatically relaunches itself with
  `AutoHotkey32.exe`.
- PowerScribe and AutoHotkey should run at the same Windows privilege level.

The bridge was developed and tested on PowerScribe 360 version **7.0.111.7**.
Other PowerScribe versions may have different internal classes or methods.

## How to use it

1. Install AutoHotkey v2.
2. Save `PowerScribe360_AHK_Internal_Bridge.ahk` somewhere convenient.
3. Double-click the AHK file.
4. Start PowerScribe 360 if it is not already running.
5. Use the hotkeys below.

The script can start before or after PowerScribe. It checks for PowerScribe
periodically and attaches when PowerScribe is available.

## Primary hotkeys

| Hotkey | PowerScribe action |
|---|---|
| Alt+F1 | Toggle dictation |
| Alt+F2 | Previous report field |
| Alt+F3 | Next report field |
| Alt+F4 | Sign report |
| Alt+F5 | Enter Findings mode |
| Alt+F6 | Exit Findings mode |
| Alt+F7 | Apply Findings |
| Alt+F8 | Draft |
| Alt+F9 | Correct |
| Alt+F10 | Sign Preliminary |
| Alt+F11 | AutoFeed |
| Alt+F12 | Close report |

Previous/Next field are sent to PowerScribe **without bringing PowerScribe to
the foreground**, so PACS can remain active.

If dictation is running while Previous/Next field is used, the bridge uses the
PowerScribe internal sequence that pauses dictation, changes fields, and
resumes dictation.

## Secondary hotkeys

These commands exist inside PowerScribe, but some are dependent on site
configuration, user role, report state, or installed modules.

| Hotkey | PowerScribe action |
|---|---|
| Alt+Shift+F1 | Save |
| Alt+Shift+F2 | Undo |
| Alt+Shift+F3 | Redo |
| Alt+Shift+F4 | Check Spelling |
| Alt+Shift+F5 | Compare Revisions |
| Alt+Shift+F6 | Insert Prior |
| Alt+Shift+F7 | Insert Note |
| Alt+Shift+F8 | Follow-up Recommendations |
| Alt+Shift+F9 | Critical Message |
| Alt+Shift+F10 | Peer Review |
| Alt+Shift+F11 | Wet Read |
| Alt+Shift+F12 | Launch PACS |

A secondary command that is unavailable in the current PowerScribe context may
simply do nothing.

## Why Discard is not mapped

PowerScribe's internal `Discard` command is included in the bridge, but the
script intentionally does **not** assign it a hotkey because an accidental
keypress could discard a report.

## How it works, in simple English

A normal AutoHotkey macro usually works like this:

1. Bring PowerScribe to the front.
2. Pretend to press a key such as F4, Tab, or Shift+Tab.
3. Hope PowerScribe processes that shortcut correctly.

This script uses a different path.

### 1. AutoHotkey finds PowerScribe

The script finds the PowerScribe window and the Windows thread that owns its
user interface.

### 2. It installs a small hook only on that PowerScribe UI thread

The script creates two small temporary 32-bit DLLs in the Windows temp folder.
It uses the Windows `WH_GETMESSAGE` hook mechanism to load the small hook into
PowerScribe's UI thread.

This is **not a system-wide keyboard hook**.

### 3. AutoHotkey sends PowerScribe a private message

When a hotkey is pressed, AutoHotkey sends a private Windows message to
PowerScribe containing a small command number.

For example, one command number means "Next Field" and another means
"Sign Report."

### 4. The bridge receives the message inside PowerScribe

Because the hook is running in PowerScribe's process, it can obtain the actual
live PowerScribe `MainForm` .NET object.

### 5. The bridge calls PowerScribe's own internal command

The bridge uses .NET reflection to call PowerScribe's internal methods, such as
its button-action and voice-command handlers.

So the path is approximately:

    Hotkey
      -> AutoHotkey
      -> private Windows message
      -> PowerScribe UI-thread hook
      -> PowerScribe internal .NET command

That avoids most of the focus and timing problems associated with simulated
PowerScribe keyboard shortcuts.

## Does this modify PowerScribe?

No PowerScribe program files are changed.

The bridge DLLs are generated in the Windows temporary folder each time the
script starts. The hook is removed when the AutoHotkey script exits.

## Security / IT note

The script uses `SetWindowsHookEx` to load a small DLL into the PowerScribe
process. That is a legitimate Windows mechanism, but endpoint-security
software may treat process hooking or DLL loading as sensitive behavior.

On a managed workstation, local IT/security policy may block it or require
approval.

## Changing the hotkeys

All user-facing hotkeys are grouped near the top of the AHK file under:

    HOTKEYS

AutoHotkey v2 modifier symbols used there are:

- `!` = Alt
- `+` = Shift
- `^` = Ctrl
- `#` = Windows key

For example:

    !F4

means Alt+F4.

## Troubleshooting

### "PowerScribe is not running"

Start PowerScribe and try the hotkey again.

### The script says it cannot find 32-bit AutoHotkey

Install AutoHotkey v2 with its 32-bit executable. The PowerScribe build this
bridge was written for is 32-bit, so the hook must also be 32-bit.

### A secondary command does nothing

That operation may not be active for the current report, user role, site
configuration, or PowerScribe module.

### A major PowerScribe upgrade breaks the script

This project calls PowerScribe's internal .NET methods. Those internal names
are not a public API and can change between releases. A major update may
require the bridge to be adjusted.

## Disclaimer

This is an unofficial workflow tool and is not affiliated with or supported by
Microsoft/Nuance. Test commands in a safe environment before relying on them
clinically.

Good luck!

16 Comments

Dave 10.12.26 Reply

Funny I was just trying this out at work for the first time today as you posted this. The script on your post is more like a readme description. Can you provide the actual script that I can copy and paste into autohotkey to achieve this functionality? I have 32 bit PS360

Dave 10.12.26 Reply

I see it now. Thanks

Ben 10.12.26 Reply

Hope it works well for you!

Darren Fitzpatrick 10.14.26 Reply

This is cool Ben. Thank you. I was just in the midst of setting up AHK with Contour Shuttle Pro with my IT people today. Mapping the PACS keyboard shortcuts is easy. Setting the to PS is way more complicated so the timing of this post is perfect. So we just map the key strokes for each function to the Shuttle Pro?

Ben 10.15.26 Reply

Exactly. So if using the example script, you map the combination of “Alt+F1” to whatever button you want to control toggling dictation.

Max 10.23.26 Reply

I’ve configured the Contour Shuttle and installed AutoHotKey 2.0 but can’t seem to get this working. Do I copy and paste the entire control script (second grey box) into notepad with a ‘.ahk’ extension and simply run the script? Any help would be greatly appreciated

Ben 11.04.26 Reply

I added a direct download link, so you can just download and run the script.

Jon b 10.26.26 Reply

Save the second text as an ahk file and run. This will link alt f1-f12 to perform the functions as described. After launching it, you can test if it is working by pressing alt f1 and see if it toggles dictation. If that works, at the shuttle keys the the f keys.

This has only been tried on one version of powerscribe 360. If it still doesn’t work, upload the file to your favorite AI and tell it what issues you are having and it likely will be able to fix it.

Max Quellhorst 11.02.26 Reply

I’ve got the same error message as other people stating:

PowerScribe bridge setup failed.
C# bridge compilation failed
Compiler output copied to clipboard.

Ben 11.04.26

Something about the pasted code was adding in an error. I’ve gone ahead and just uploaded/linked to the actual AHK file in the post.

Gen 10.26.26 Reply

I have tried this but get an error message when using:
PowerScribe bridge setup failed.
C# bridge compilation failed
Compiler output copied to clipboard.

ChatGPT suggested some changes that did not help.

Ben 11.04.26 Reply

Something about the pasted code was adding in an error. I’ve gone ahead and just uploaded/linked to the actual AHK file.

Michael 11.04.26 Reply

I’m so excited to try this out tomorrow. I’ve been using a very simple script with AHK but would like to do a lot more — essentially the only functions I use are toggle dictation and next / previous field. I used chatGPT to set up the initial script, which thankfully works, because when I used it to try to alter the script to change the hotkeys, every subsequent iteration failed completely.

I’ve been stumbling around in the dark for the past few months and a Google AI post led me here and this looks much more foolproof than what I’ve been doing.

Thanks, Ben! Always enjoy your stuff.

Greg 11.06.26 Reply

I have heard about this tool and the use by radiologists. It appears to be a great product. My organization risk assessments for all applications. Have you ran into this?
It looks like the script uses Python. Python has current exploitations in the wild.

Ben 11.06.26 Reply

I don’t actually use this day to day. Some people complain about the lag, but with my dictation style I’ve been content and hadn’t really had issues. I still use my simpler AHK script, but some institutions block AHK in general. It can be a fight.

Leave a Reply