Docs

RunMacro Documentation

Learn RunMacro from basics to advanced.

Everything you need to start and master RunMacro — from basic commands to advanced automation workflows.

Ctrl K

🔑 Features

Activate your RunMacro license

Open Settings › License, click Copy machine ID and send it to the seller. When you get the key, paste it into the License key field and press Activate license.

Prerequisites

A purchased license key, starting with PMACRO1 and made of three dot-separated parts.
The Machine ID of the machine you want to activate, sent to the seller.
Internet access for the first activation.
No key is needed to start using the app: you get a trial first, and when it ends the app drops to limited Free mode rather than refusing to open.

Supported modes

Desktop Mode
Browser Mode
QMacro Runner

What it does

License activation binds a purchased key to one machine. You copy the Machine ID derived from your hardware, send it to the seller, receive a key, then paste it and press activate. Verification happens on the server, which returns a signed token the app caches — so later launches need no network call and short outages do not stop you working.

When to use it

You just bought a license and need the paid features unlocked.
The trial ended and the app dropped to limited Free mode.
You moved to a new machine and need to activate again.
You need to remove the license from a machine before selling or returning it.

When not to use it

You only need the basic commands: the Free tier is enough and no activation is needed.
You have not bought a key yet — try the trial first to see whether it fits your needs.
You want one key on several machines at once: each key binds to a single machine ID.

Configuration steps

Open Settings › License.
Click Copy machine ID. The ID goes to your clipboard.
Send the machine ID to the seller. The Contact to buy Pro button both copies it and lists what to send.
Receive the key and paste it into the License key field. Press Show to double-check what you pasted.
Press Activate license.
On success the expiry date appears and paid features unlock immediately, with no restart needed.
Verify in the summary panel above: current plan and expiry date.

Every option explained

Machine ID

A string derived from your hardware and OS details, shown as four eight-character groups. Every machine has a different ID, so a key issued for one machine will not work on another.

License key

The key field, masked by default. Press Show/Hide to reveal or mask it, and Copy to copy the saved key.

Copy machine ID

Copies the machine ID to the clipboard so you can send it when buying or asking for license support.

Contact to buy Pro

Copies the machine ID and opens an info box listing what to send the seller.

Activate license

Sends the key with your machine ID to the server for verification. On success the key is stored encrypted locally; on failure the server message is shown and nothing is saved.

Remove license

Deletes the saved key and the verification cache from this machine, after confirmation. Use it when moving or returning a machine. You must enter the key again to restore paid features.

Expected result

The status bar and summary panel show the activated plan and expiry date. Advanced commands in the command library lose their padlock icons. The upgrade card in the sidebar disappears while the license is valid.

Real example

Example: first activation after buying

Open Settings › License and click Copy machine ID.
Send the machine ID to the seller and wait for your license key.
Paste the key into License key, press Show to proofread it.
Press Activate license and wait for the confirmation with the expiry date.
Open the command library to check: advanced commands no longer show padlocks.

Example: move a license to a new machine

On the old machine: open Settings › License, press Remove license and confirm.
On the new machine: open Settings › License and press Copy machine ID.
Send the new machine ID to the seller so the key can be rebound.
Paste the key and press Activate license.
If the server reports the key is bound to another machine, contact the seller to rebind before retrying.

Limitations and failure cases

Each key binds to one machine ID. Changing machines (or hardware changes that alter the ID) requires the seller to rebind the key.
The first activation requires a network. After that the app uses a signed token, so it opens offline for about 72 hours from the last online verification.
Within the 6-hour window between online checks, the app trusts the cached token. If a key is revoked, the change takes effect at the next check, up to about 6 hours later.
Setting the system clock backwards during the trial locks the trial.
The Free tier only allows the basic command groups; advanced commands appear locked and a macro containing them is blocked at run time. The Free tier has no limit on how many commands a macro may hold.
Specific rejection messages (bad signature, wrong machine, revoked, expired) come from the server and are shown verbatim in the dialog.

Tips & common mistakes

Send the machine ID of the machine you will actually use. A key issued against a different ID will not activate.

Before selling or returning a machine, press Remove license so the key does not stay behind on it.

The key is stored encrypted with Windows DPAPI, not as plain text in the settings file.

After activating, the app keeps working through short outages. Do not stay offline too long though — past about 72 hours it needs a connection to re-verify.

A yellow padlock in the command library means that command needs a license. Clicking it shows a prompt to enter a key.

Verification details

core/license.py
core/license_client.py
ui/license_status_card.py