normcap icon indicating copy to clipboard operation
normcap copied to clipboard

--help gives error

Open JoeBarouneD opened this issue 3 months ago • 2 comments

What happened?

On Windows (portable install), "Normcap.exe --help" gives an error.

Image Image

How did you install NormCap?

None

Operating System + Version?

Windows 11

[Linux only] Display Server (DS) + Desktop environment (DE)?

No response

Debug log output?*


JoeBarouneD avatar Sep 01 '25 08:09 JoeBarouneD

Thanks for reporting this issue.

For now, with #784 , I implemented a workaround which avoids the crash and prints the helptext.

I call it "workaround", because it has a downside: the next terminal prompt is messy, especially in PowerShell. The cursor will remain in the line of the last prompt, so the user basically starts typing the next command after NormCap.exe --help somewhere in the middle of the help text itself. (Multiple presses of Enter or a cls+Enter will bring you back to a normal prompt). Note that this is purely cosmetical, the chars of the help text will of course never become part of the next command.

dynobo avatar Sep 02 '25 22:09 dynobo

Oh, and until the fix is released, here's the help for NormCap v0.6.0:

usage: normcap [-h] [-c COLOR] [-l LANGUAGE [LANGUAGE ...]]
               [--parse-text {True,False}] [--detect-codes {True,False}]
               [--detect-text {True,False}] [-n {True,False}]
               [-t {True,False}] [-u {True,False}]
               [--show-introduction {True,False}] [--reset]
               [-v {error,warning,info,debug}] [--log-file LOG_FILE]
               [--version] [--cli-mode] [--background-mode]
               [--screenshot-handler {qt,grim,gnome_screenshot,spectacle,dbus_portal}]
               [--clipboard-handler {windll,pbcopy,qt,xsel,xclip,wlclipboard}]
               [--notification-handler {dbus_portal,notify_send,qt}]

OCR-powered screen-capture tool to capture information instead of images.

options:
  -h, --help            show this help message and exit
  -c, --color COLOR     Set primary color for UI, e.g. '#FF2E88' (default:
                        #FF2E88)
  -l, --language LANGUAGE [LANGUAGE ...]
                        Set language(s) for text recognition, e.g. '-l eng' or
                        '-l eng deu' (default: eng)
  --parse-text {True,False}
                        Try to determine the text's type (e.g. line,
                        paragraph, URL, email) and format the output
                        accordingly. (default: True)
  --detect-codes {True,False}
                        Detect barcodes and QR codes. (default: True)
  --detect-text {True,False}
                        Detect text using ocr. (default: True)
  -n, --notification {True,False}
                        Disable or enable notification after ocr detection
                        (default: True)
  -t, --tray {True,False}
                        Disable or enable system tray (default: False)
  -u, --update {True,False}
                        Disable or enable check for updates (default: False)
  --show-introduction {True,False}
                        Show introductional screen on start (default: True)
  --reset               Reset all settings to default values
  -v, --verbosity {error,warning,info,debug}
                        Set level of detail for console output (default:
                        warning)
  --log-file LOG_FILE   Save console output to a file
  --version             Print NormCap version and exit
  --cli-mode            Print text after detection to stdout and exits
                        immediately
  --background-mode     Start minimized to tray, without capturing
  --screenshot-handler {qt,grim,gnome_screenshot,spectacle,dbus_portal}
                        Only relevant on Linux! Force using specific
                        screenshot handler instead of auto-selecting
  --clipboard-handler {windll,pbcopy,qt,xsel,xclip,wlclipboard}
                        Force using specific clipboard handler instead of
                        auto-selecting
  --notification-handler {dbus_portal,notify_send,qt}
                        Only relevant on Linux! Force using specific
                        notification handler instead of auto-selecting

dynobo avatar Sep 07 '25 09:09 dynobo