Overview

Narratus turns a screen-recorded workflow video into a professional Standard Operating Procedure complete with reviewed screenshots and a polished Word document export. Narratus uses a managed subscription service — no API key setup required. Purchase a plan at getnarratus.com and receive an activation key by email. The AI (OpenAI Whisper transcription and GPT SOP writing) is handled entirely through Narratus's managed service.

Workflow

What's Included in v22.3

• Managed AI pipeline — OpenAI Whisper transcription and GPT SOP writing, fully managed through your Narratus subscription. No user API key required.
• Subscription tiers — Basic (5 runs/month), Professional (20 runs/month), Business (100 runs/month), Enterprise (300 runs/month).
• Activation key licensing — one key per device (seat), monthly run quota shared across all seats on the account.
• Automatic update notifications — a blue banner appears at the top of the window when a newer version is available, with a Download update button.
• Menu bar — File (Load Project, Recent Projects, Settings, Exit) and Help (Help, About) menus.
• Load Project — reopen and re-edit any previous Narratus output folder.
• Recent Projects — quick access to the last 5 projects from the File menu.
• About dialog — version info, description, and copyright.
• Settings — user profile, activation key, branding, and theme (Light / Dark / System).
• Screenshot review — thumbnail sidebar, crop tool, delete/restore, editable captions.
• SOP editor — review and edit the generated Markdown before export.
• DOCX export — title block, Table of Contents, formatted headings, embedded screenshots, and screenshot appendix.
• PDF export — via Microsoft Word automation (Windows) or LibreOffice (Linux).
• Document branding — upload a company logo for DOCX/PDF output.
• Local help guide — available from the Help menu.

Install & Run

Install dependencies

pip install -r requirements.txt

Run from source (Linux / macOS)

export PYTHONPATH=src
python main.py

Run from source (Windows PowerShell)

cd "D:\Narratus\v22_windows"
$env:PYTHONPATH = "src"
python main.py

Or install in editable mode (all platforms)

pip install -e .
python main.py

Activating Your License

Narratus uses a subscription model — no external API key setup is required. All AI is managed through your subscription.

Get an activation key

Purchase a subscription at getnarratus.com. Your activation key is emailed to you after purchase. The key format is: NRTS-XXXX-XXXX-XXXX-XXXX.

Enter your key

Open File → Settings in Narratus, enter your activation key in the Activation Key field, and click Verify.

Your plan, seats used, runs remaining, and reset date appear in the Settings window and in the status strip at the bottom of the main window.

No API key required

All AI — including OpenAI Whisper transcription and GPT SOP generation — is managed through your Narratus subscription. You do not need to obtain or configure any external API keys.

Moving to a new device

Each activation key is tied to one device. To move to a new computer, click Deregister This Device in Settings on the old computer first. Then open Settings on the new computer, enter the same key, and click Verify. If you no longer have access to the old computer, contact Narratus support.

How to Use

1. Open the app.
2. Go to File → Settings, enter your activation key, and click Verify to activate your subscription.
3. Choose a video file.
4. Choose an output folder.
5. Enter an SOP title.
6. Enter screenshot keywords, for example:

   click, open, select, save, submit, next, settings

7. Click Run Pipeline.
8. In the screenshot review window — edit captions, crop, or delete screenshots. Click Continue to SOP.
9. Review and edit the SOP text in the editor.
10. Click Save & Export and choose DOCX, PDF, or both.

Output is saved in your chosen output folder as sop.docx and/or sop.pdf. The editable Markdown draft is saved as sop.md.

Load a Previous Project

Go to File → Load Project and choose a folder previously created by Narratus. The app skips the pipeline entirely and reopens the SOP editor with the saved screenshots and text. All changes are saved back to the same folder.

Your five most recently opened projects are listed under File → Recent Projects for quick access without browsing.

Screenshot Placement in DOCX

Narratus looks for screenshot placeholders in the SOP text:

[Screenshot 1]

Place these anywhere in the SOP editor using the Insert button in the screenshot panel. Any kept screenshots not referenced in the text are automatically added to a Screenshot Appendix at the end of the Word document.

PDF Export

• Windows — uses Microsoft Word automation. Word must be installed and activated.
• Linux — uses LibreOffice if installed.

If PDF export fails on Windows with a pywin32 error:

pip install pywin32

Then restart VS Code and try again.

Building with PyInstaller

From the project root on Windows:

pyinstaller "Narratus.spec"

The distributable folder will be at dist/Narratus/.