QHuman

Back up and share your macros

Export a macro you already built to a single .qhz file, then import it right back to prove the round trip works. Once you trust it, you can move macros to a new PC, hand them to a friend, or keep a backup before a reinstall.

export import backup Free 8 min

Every macro you build lives inside QHuman until you decide to move it. A .qhz file is how it travels, and the figure below is everything a shared export packs.

The full-library backup is a different button with a bigger bag; your account never travels in either.

This one has no practice target and no score to read. Bring a macro you built earlier, like the one from the first-macro lab.

Do the round trip

  1. Pick a macro you already built In the macro list, select one you know well. You want something familiar so you can spot if anything changes on the way back.
  2. Export it to a .qhz Right-click the macro and choose Export.... The save dialog is titled Export macros and offers the macro's own name as the filename; save it anywhere handy.
    The macro list's right-click menu. Export... and Import shared file... sit as a pair, so the whole round trip lives in one menu.
  3. Import it back with Import shared file... Click Import shared file... under the macro list and choose the .qhz you just saved. It also lives in Settings → Backup & Share.
  4. Read the Review this import preview Before anything lands, QHuman shows what the file contains and what will change in your library. A shared import always merges: it never overwrites what you already have, and since your original is still sitting in the list, the incoming copy arrives renamed. Check your preview against the figure, then click Import.
    The preview for your own file coming straight back. In its counts, the binding is the entry in your macro list and the macro is the recorded sequence under it. Those two "What will change" lines are the merge in action: your entry renamed, the identical sequence reused instead of duplicated.
  5. Find the imported copy in the list The copy lands next to your original with (imported) on its name, idle, and with any hotkey left unbound, so nothing can run until you say so. Load it and read its action list against the original: same rows, same timing. That side-by-side is the proof the file carried everything.
    Original and copy, side by side.
Checkpoint

The preview's What will change reported a merge that overwrites nothing, and after Import the copy sits in your list as (imported), matching the original row for row. The Import complete box says the rest: imported items stay idle until you start them. On a machine that has never seen this macro, the same .qhz arrives under its original name, since there is nothing to clash with. That is a proven round trip.

Make it yours

Do the round trip cold, not same-session: export the macro, delete it from your library, quit QHuman, reopen, and Import shared file the .qhz. That is a real reinstall, not a re-import into a running app, and with the original gone the macro comes back under its own name, no (imported) this time. If you have built a detection macro in another lab, export that one too and watch the preview's counts list its image, so you trust that a .qhz packs images, not just clicks.

If it went wrong

  • QHuman says the file does not look like a share file The exact message is This doesn't look like a QHuman share file, or it's damaged. The file got renamed, cut short in transit, or is not a .qhz at all. Re-export and try the fresh file.
  • The macro came back but a detection image is missing Re-export from the original macro. A .qhz carries its detection images automatically, so a fresh export should pack them in.
  • You expected it to overwrite the old one Shared imports always merge, never replace. Overwriting the whole library only happens when you restore a full backup and pick its Replace my library option.
  • The imported macro started running on its own It should not. Imports arrive idle, and even their hotkeys arrive unbound. If something is running, it was already running before the import, so stop it and try the round trip again.

Stuck?

Grab a sample .qhz. Download it and open QHuman's Import shared file... to load it, then watch the Review this import preview so you know what a clean import looks like.

Download the solution (.qhz)

Keep going

Want the full detail, including full-library backups and what stays out of the file? Read the Backup & Share guide. Or head back to the practice targets and build another macro worth backing up.