### Install Dependencies on Linux (Fedora)

Source: https://github.com/dynobo/normcap/blob/main/README.md

Installs Tesseract OCR and clipboard utilities for NormCap on Fedora.

```sh
## Install dependencies (Fedora)
sudo dnf install tesseract wl-clipboard
```

--------------------------------

### Install and Run NormCap on Windows

Source: https://github.com/dynobo/normcap/blob/main/README.md

Installs the NormCap Python package using pip and then runs the application.

```bash
# Install normcap
pip install normcap

# Run
normcap
```

--------------------------------

### Install Dependencies on Linux (openSUSE)

Source: https://github.com/dynobo/normcap/blob/main/README.md

Installs Python development headers, Tesseract OCR, and clipboard utilities for NormCap on openSUSE.

```sh
## Install dependencies (openSUSE)
sudo zypper install python3-devel tesseract-ocr tesseract-ocr-devel wl-clipboard
```

--------------------------------

### Install Qt Wayland for Fedora

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Install the Qt Wayland package on Fedora to resolve Qt platform plugin errors.

```bash
dnf install qt6-qtwayland
```

--------------------------------

### Install Dependencies on Linux (Arch)

Source: https://github.com/dynobo/normcap/blob/main/README.md

Installs Tesseract OCR and clipboard utilities for NormCap on Arch Linux.

```sh
## Install dependencies (Arch)
sudo pacman -S tesseract tesseract-data-eng wl-clipboard
```

--------------------------------

### Install and Run NormCap on macOS

Source: https://github.com/dynobo/normcap/blob/main/README.md

Installs Tesseract OCR and language data using Homebrew, then installs NormCap via pip and runs it.

```sh
# Install dependencies
brew install tesseract tesseract-lang

# Install normcap
pip install normcap

# Run
./normcap
```

--------------------------------

### Install and Run NormCap on Linux

Source: https://github.com/dynobo/normcap/blob/main/README.md

Installs the NormCap Python package using pip and then runs the application.

```sh
# Install normcap
pip install normcap

# Run
./normcap
```

--------------------------------

### Clone Repository and Install Dependencies

Source: https://github.com/dynobo/normcap/blob/main/README.md

Commands to clone the Normcap repository, set up the virtual environment, install dependencies using uv, and register the pre-commit hook.

```sh
git clone https://github.com/dynobo/normcap.git

cd normcap

uv sync

uv run prek install
```

--------------------------------

### Install Qt Wayland for Debian/Ubuntu

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Install the Qt Wayland package on Debian or Ubuntu to resolve Qt platform plugin errors.

```bash
apt install qt6-wayland
```

--------------------------------

### Install XCB dependencies for Fedora

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Install XCB and XCB cursor utilities on Fedora to resolve Qt platform plugin errors.

```bash
dnf install libxcb xcb-util-cursor
```

--------------------------------

### Install Dependencies on Linux (Ubuntu/Debian)

Source: https://github.com/dynobo/normcap/blob/main/README.md

Installs essential build tools, Tesseract OCR, and clipboard utilities required for NormCap on Ubuntu/Debian-based systems.

```sh
# Install dependencies (Ubuntu/Debian)
sudo apt install build-essential tesseract-ocr tesseract-ocr-eng libtesseract-dev libleptonica-dev wl-clipboard
```

--------------------------------

### Install Qt Wayland for Arch Linux

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Install the Qt Wayland package on Arch Linux to resolve Qt platform plugin errors.

```bash
pacman -S qt6-wayland
```

--------------------------------

### Test Tesseract Installation on Windows

Source: https://github.com/dynobo/normcap/blob/main/README.md

Verifies the Tesseract OCR installation by listing available languages in a new command prompt terminal.

```cmd
tesseract --list-langs
```

--------------------------------

### Install Normcap using Flatpak on Linux

Source: https://github.com/dynobo/normcap/blob/main/README.md

Use these commands to add the Flathub repository and install Normcap if you are on a Linux distribution that supports Flatpak.

```sh
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub com.github.dynobo.normcap
```

--------------------------------

### Install XCB dependencies for Debian/Ubuntu

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Install XCB and XCB cursor utilities on Debian or Ubuntu to resolve Qt platform plugin errors.

```bash
apt install libxcb1 libxcb-cursor0
```

--------------------------------

### Install FUSE for AppImages on Ubuntu

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Install the FUSE library on Ubuntu 22.04 to resolve the 'AppImages require FUSE to run' error.

```bash
sudo apt install libfuse2
```

--------------------------------

### Install XCB dependencies for Arch Linux

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Install XCB and XCB cursor utilities on Arch Linux to resolve Qt platform plugin errors.

```bash
pacman -S libxcb xcb-util-cursor
```

--------------------------------

### Show Flatpak Permissions for NormCap

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

View the current screenshot permissions for the NormCap Flatpak installation.

```bash
flatpak permission-show com.github.dynobo.normcap
```

--------------------------------

### Set Language for NormCap (Windows MSI)

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Set the LANG environment variable and run NormCap using the MSI installed version on Windows.

```batch
set LANG=<LOCALE_NAME>
%LOCALAPPDATA%\Programs\NormCap\NormCap.exe
```

--------------------------------

### Generate GIF from Video using FFmpeg

Source: https://github.com/dynobo/normcap/blob/main/assets/screencast/README.md

Use this FFmpeg command to convert a video file into a GIF with specific scaling and color palette settings. Ensure FFmpeg is installed and accessible in your PATH.

```bash
ffmpeg -i normcap_demo.mp4 -r 8 -vf "scale=825:-1,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" normcap.gif
```

--------------------------------

### Set Language for NormCap (macOS DMG)

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Run NormCap using the DMG installation on macOS with a specific locale set.

```bash
LANG=<LOCALE_NAME> /Applications/NormCap.app/Contents/MacOS/NormCap
```

--------------------------------

### Enable Debug Logging in NormCap

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Launch NormCap from the terminal with the `--verbosity debug` or `-v debug` flag to get additional console output for troubleshooting.

```bash
normcap --verbosity debug
normcap -v debug
```

--------------------------------

### Set Language for NormCap (Linux FlatPak)

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Run NormCap using FlatPak on Linux with a specific locale set.

```bash
LANGUAGE=<LOCALE_NAME> flatpak run --command=normcap com.github.dynobo.normcap
```

--------------------------------

### List Applications with Screenshot Permissions (AppImage)

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Query the system to list all applications that have been granted screenshot permissions, useful when using the NormCap AppImage.

```bash
dbus-send --print-reply=literal \
  --session --dest=org.freedesktop.impl.portal.PermissionStore \
  /org/freedesktop/impl/portal/PermissionStore \
  org.freedesktop.impl.portal.PermissionStore.Lookup \
  string:'screenshot' string:'screenshot'
```

--------------------------------

### Set Language for NormCap (Windows Python Package)

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Set the LANG environment variable and run NormCap using the Python package on Windows.

```batch
set LANG=<LOCALE_NAME>
normcap
```

--------------------------------

### Create New Locale PO File

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Use this command to generate an initial messages.po file for a new language locale. Replace <LOCALE_NAME> with the appropriate locale identifier (e.g., en_EN, de_AT).

```sh
uv run poe locales-create <LOCALE_NAME>
```

--------------------------------

### Workaround for NormCap clipboard issue on KDE + Wayland

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Pipe NormCap output to /dev/null to potentially resolve clipboard issues when launched via shortcut on KDE + Wayland.

```bash
normcap 2>&1 | tee /dev/null
```

--------------------------------

### Set Language for NormCap (Linux AppImage)

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Run NormCap using the AppImage on Linux with a specific locale set.

```bash
LANGUAGE=<LOCALE_NAME> NormCap-[…].AppImage
```

--------------------------------

### Set Language for NormCap (Linux Python Package)

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Run NormCap using the Python package on Linux with a specific locale set.

```bash
LANGUAGE=<LOCALE_NAME> normcap
```

--------------------------------

### Run NormCap

Source: https://github.com/dynobo/normcap/blob/main/README.md

Command to run the NormCap application within the established virtual environment.

```sh
uv run python -m normcap
```

--------------------------------

### Set Flatpak Screenshot Permission for NormCap

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Explicitly grant screenshot permissions to the NormCap Flatpak if they are missing.

```bash
flatpak permission-set screenshot screenshot com.github.dynobo.normcap yes
```

--------------------------------

### Compile PO to MO File

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

After editing or creating a .po translation file, compile it into the machine-readable .mo format using this command.

```sh
uv run poe locales-compile
```

--------------------------------

### Update Locales

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Generates a .pot file and updates all existing .po files. This command is necessary when translatable strings in NormCap's source code have been changed.

```sh
uv run poe locales-update
```

--------------------------------

### Grant Screenshot Permission to NormCap AppImage

Source: https://github.com/dynobo/normcap/blob/main/docs/faqs.md

Grant screenshot permission to the NormCap AppImage using dbus-send if it's not already set.

```bash
dbus-send --print-reply=literal \
  --session --dest=org.freedesktop.impl.portal.PermissionStore \
  /org/freedesktop/impl/portal/PermissionStore \
  org.freedesktop.impl.portal.PermissionStore.SetPermission \
  string:'screenshot' boolean:true string:'screenshot' \
  string:'com.github.dynobo.normcap' array:string:['yes']
```

--------------------------------

### Test Translation with Environment Variable

Source: https://github.com/dynobo/normcap/blob/main/normcap/resources/locales/README.md

Run Normcap with the LANGUAGE environment variable set to your locale name to test your new or updated translations.

```sh
LANGUAGE=<LOCALE_NAME> python normcap/app.py
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.