# no_vtf-desktop
Desktop integration for [no_vtf](https://git.sr.ht/~b5327157/no_vtf) (Linux-only).
[](https://pypi.org/project/no-vtf-desktop/)
[](https://pypistats.org/packages/no-vtf-desktop)
[](https://spdx.org/licenses/GPL-3.0-or-later.html)
[](https://git.sr.ht/~b5327157/no_vtf-desktop)
[](https://builds.sr.ht/~b5327157/no_vtf-desktop/commits)
[](https://api.reuse.software/info/git.sr.ht/~b5327157/no_vtf-desktop)
[](https://github.com/wntrblm/nox)
---
⌂ [Project pages](https://sr.ht/~b5327157/no_vtf/sources)
\# [Source code](https://git.sr.ht/~b5327157/no_vtf-desktop/tree)
~ [Changelog](https://git.sr.ht/~b5327157/no_vtf-desktop/refs)
\> [Mailing list](https://lists.sr.ht/~b5327157/no_vtf)
\+ [Ticket tracker](https://todo.sr.ht/~b5327157/no_vtf)
❡ [Wiki](https://developer.valvesoftware.com/wiki/no_vtf)
---
## 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](https://peps.python.org/pep-0668/), 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](https://pipx.pypa.io/stable/))
```
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](https://spdx.org/licenses/GPL-3.0-or-later.html).
Raw data
{
"_id": null,
"home_page": "https://git.sr.ht/~b5327157/no_vtf-desktop",
"name": "no-vtf-desktop",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "no_vtf,Source Engine,VTF,Valve Texture Format",
"author": "b5327157",
"author_email": "b5327157@protonmail.com",
"download_url": "https://files.pythonhosted.org/packages/30/13/62a83ecc01ecf5566bfcdeac111dde47c16a1859ba673e35a9c6de0943ef/no_vtf-desktop-0.1.3.tar.gz",
"platform": null,
"description": "# no_vtf-desktop\n\nDesktop integration for [no_vtf](https://git.sr.ht/~b5327157/no_vtf) (Linux-only).\n\n\n[](https://pypi.org/project/no-vtf-desktop/)\n[](https://pypistats.org/packages/no-vtf-desktop)\n[](https://spdx.org/licenses/GPL-3.0-or-later.html)\n[](https://git.sr.ht/~b5327157/no_vtf-desktop)\n[](https://builds.sr.ht/~b5327157/no_vtf-desktop/commits)\n[](https://api.reuse.software/info/git.sr.ht/~b5327157/no_vtf-desktop)\n[](https://github.com/wntrblm/nox)\n\n---\n\n\u2302 [Project pages](https://sr.ht/~b5327157/no_vtf/sources)\n\\# [Source code](https://git.sr.ht/~b5327157/no_vtf-desktop/tree)\n~ [Changelog](https://git.sr.ht/~b5327157/no_vtf-desktop/refs)\n\\> [Mailing list](https://lists.sr.ht/~b5327157/no_vtf)\n\\+ [Ticket tracker](https://todo.sr.ht/~b5327157/no_vtf)\n\u2761 [Wiki](https://developer.valvesoftware.com/wiki/no_vtf)\n\n---\n\n## Features\n\n- application entry (open `.vtf` to convert in-place)\n- thumbnailer (preview `.vtf` directly in file manager)\n\n## Requirements\n\n- Python 3.10 or newer\n- XDG-compliant desktop environment\n- GNOME-compatible thumbnailing system (KDE specifically is not supported)\n\n## Installation\n\nTo 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.\n\nAs of [PEP 668](https://peps.python.org/pep-0668/), 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.\n\n### Automated (via [pipx](https://pipx.pypa.io/stable/))\n\n```\npipx install no_vtf-desktop\nno_vtf-desktop\n```\n\n### Manual\n\n#### Virtual environment\n\n```\npython3 -m venv no_vtf-desktop-venv\nsource no_vtf-desktop-venv/bin/activate\npython3 -m pip install no_vtf-desktop\nno_vtf-desktop\n```\n\n#### User home directory\n\n```\nPIP_BREAK_SYSTEM_PACKAGES=1 python3 -m pip install --user no_vtf-desktop\npython3 -m no_vtf_desktop\n```\n\n#### System-wide\n\n```\nsudo PIP_BREAK_SYSTEM_PACKAGES=1 python3 -m pip install no_vtf-desktop\nno_vtf-desktop\n```\n\n## Uninstallation\n\n```\nno_vtf-desktop-uninstall || python3 -m no_vtf_desktop_uninstall\n```\n\n## Known issues\n\n### GNOME\n\nDue 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.\n\n## License\n\nThe package is licensed under [GNU GPL v3.0 or later](https://spdx.org/licenses/GPL-3.0-or-later.html).\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Desktop integration for no_vtf (Linux-only)",
"version": "0.1.3",
"project_urls": {
"Changelog": "https://git.sr.ht/~b5327157/no_vtf-desktop/refs",
"Homepage": "https://git.sr.ht/~b5327157/no_vtf-desktop",
"Mailing list": "https://lists.sr.ht/~b5327157/no_vtf",
"Ticket tracker": "https://todo.sr.ht/~b5327157/no_vtf",
"Wiki": "https://developer.valvesoftware.com/wiki/no_vtf"
},
"split_keywords": [
"no_vtf",
"source engine",
"vtf",
"valve texture format"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "638ea540556119e8c2629f59e00e0cdb5f17fc74fa781bad10a3c7e093e5c7d9",
"md5": "170ae8423b76e9e70487b60c9bb50fc4",
"sha256": "c6857bba8d14a12b671912cae680d86e0b18305192af6bd1472596cd74688a27"
},
"downloads": -1,
"filename": "no_vtf_desktop-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "170ae8423b76e9e70487b60c9bb50fc4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 60271,
"upload_time": "2024-02-16T18:57:08",
"upload_time_iso_8601": "2024-02-16T18:57:08.217262Z",
"url": "https://files.pythonhosted.org/packages/63/8e/a540556119e8c2629f59e00e0cdb5f17fc74fa781bad10a3c7e093e5c7d9/no_vtf_desktop-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "301362a83ecc01ecf5566bfcdeac111dde47c16a1859ba673e35a9c6de0943ef",
"md5": "cc99097af5e3c007773d23d19fa80434",
"sha256": "e8eec623efc41c0d6ee2db7dc1ee9ba076f391cfc2e30a2a02542ff44ea0011e"
},
"downloads": -1,
"filename": "no_vtf-desktop-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "cc99097af5e3c007773d23d19fa80434",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 66636,
"upload_time": "2024-02-16T18:57:10",
"upload_time_iso_8601": "2024-02-16T18:57:10.221165Z",
"url": "https://files.pythonhosted.org/packages/30/13/62a83ecc01ecf5566bfcdeac111dde47c16a1859ba673e35a9c6de0943ef/no_vtf-desktop-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-16 18:57:10",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "no-vtf-desktop"
}
JSON