no-vtf-desktop 0.1.0

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.

License

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