no-vtf-desktop 0.1.2

Desktop integration for no_vtf (Linux-only)

no_vtf-desktop

Desktop integration for no_vtf (Linux-only).

Features

• application entry (open .vtf to convert in-place)
• thumbnailer (preview .vtf directly in file manager)

Requirements

• Python 3.10 or newer
• XDG-compliant desktop environment
• GNOME-compatible thumbnailing system (KDE specifically is not supported)

Installation

To set up the integration, it is required to execute no_vtf-desktop after installing or upgrading the package. Internet connection is required to download the FreeImage library dependency. Re-login might be needed to load the new integration.

As of PEP 668, it is recommended to install the package into a virtual environment. Nevertheless, integration of both system-wide installation and user home directory installation is supported too.

Automated (via pipx)

pipx install no_vtf-desktop
no_vtf-desktop

Manual

Virtual environment

python3 -m venv no_vtf-desktop-venv
source no_vtf-desktop-venv/bin/activate
python3 -m pip install no_vtf-desktop
no_vtf-desktop

User home directory

PIP_BREAK_SYSTEM_PACKAGES=1 python3 -m pip install --user no_vtf-desktop
python3 -m no_vtf_desktop

System-wide

sudo PIP_BREAK_SYSTEM_PACKAGES=1 python3 -m pip install no_vtf-desktop
no_vtf-desktop

Uninstallation

no_vtf-desktop-uninstall || python3 -m no_vtf_desktop_uninstall

Known issues

GNOME

Due to thumbnailer sandboxing, GNOME is unable to use ordinary applications installed into the user's home directory for generating thumbnails. Only a system-wide installation will allow the thumbnailer to work properly.

License

The package is licensed under GNU GPL v3.0 or later.