[Bug]: Nix package fails due to Qt version mismatch

[CommentatorForAll]

Checklist

• I am using an up-to-date version.
• I have read the documentation.
• I have searched existing issues.

TagStudio Version

Latest git (rev 7176908)

Operating System & Version

NixOS 25.05

Description

i tried to run the project both with nix run github:TagStudioDev/TagStudio#tagstudio and nix run within the cloned repository, resulting in the following error messages:

2025-07-13 16:51:27 [error    ] [ThumbRenderer] Could not import the "pillow_jxl" module
Traceback (most recent call last):
  File "/nix/store/r3hf69imbw20w923x4ij5xdl9saz16ss-TagStudio-9.5.2/lib/python3.12/site-packages/tagstudio/qt/widgets/thumb_renderer.py", line 82, in <module>
    import pillow_jxl  # noqa: F401 # pyright: ignore[reportUnusedImport]
    ^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'pillow_jxl'

and later

Cannot mix incompatible Qt library (6.9.1) with this library (6.9.0)
[1]    94961 IOT instruction (core dumped)  nix run

resultin in an immediate crash.

Expected Behavior

all imports being found and not having an qt related crash

Steps to Reproduce

1. boot a nixos system
2. run nix run github:TagStudioDev/TagStudio#tagstudio

Logs

perovskite ~/coding/TagStudio  main
❯ nix run
2025-07-13 16:51:27 [info ] [FFmpeg] Using FFprobe location: ffprobe (Found)
2025-07-13 16:51:27 [info ] [FFmpeg] Using FFmpeg location: ffmpeg (Found)
2025-07-13 16:51:27 [error ] [ThumbRenderer] Could not import the "pillow_jxl" module
Traceback (most recent call last):
File "/nix/store/r3hf69imbw20w923x4ij5xdl9saz16ss-TagStudio-9.5.2/lib/python3.12/site-packages/tagstudio/qt/widgets/thumb_renderer.py", line 82, in
import pillow_jxl # noqa: F401 # pyright: ignore[reportUnusedImport]
^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'pillow_jxl'
2025-07-13 16:51:27 [info ] [ResourceManager] Resources Registered: count=31
2025-07-13 16:51:27 [info ] [Settings] Global Settings File Path not specified, using default
2025-07-13 16:51:27 [warning ] [Settings] Global Settings File does not exist creating path=PosixPath('/home/perovskite/.config/TagStudio/settings.toml')
2025-07-13 16:51:27 [info ] [Cache] Cache File not specified, using default one filename=/home/perovskite/.config/TagStudio/TagStudio.ini
2025-07-13 16:51:27 [info ] [Config] Thumbnail cache size limit: 500 MB
Cannot mix incompatible Qt library (6.9.1) with this library (6.9.0)
[1] 94961 IOT instruction (core dumped) nix run

log of nix build:

build_log.txt

[CommentatorForAll]

additional system information:
KDE Plasma Version: 6.3.5
KDE Frameworks Version: 6.14.0
Qt Version: 6.9.1

[CommentatorForAll]

Checked out the latest release tag, and the build & run fail there too
tried to run it after doing nix flake update but fails due to various reasons

[CommentatorForAll]

running nix run github:TagStudioDev/TagStudio#tagstudio-jxl fixes the missing import, but still fails due to the QT version mismatch

[xarvex]

Sorry it has taken some time for me to respond to this, I've gone on vacation as of recently.
The missing import is intentional, as TagStudio can operate with or without JXL support. As for the Qt version mismatch, it will be difficult to resolve as the two options are:

1. Override Qt's version to one compatible with the PySide version (6.8.0.2), thus compiling Qt locally.
2. Bump PySide to 6.9.1 and deal with those consequences, if any.

I am currently looking into this and what the best path is moving forward.

[CommentatorForAll]

I tried updating the project to 9.6.1 myself, but ended up having the same error message which seems weird to me. (though it might be some werid outdated chache by sheboken not having updated the bindings)
And gave up on it as i have never worked with qt before, but here is what i managed to do so far

Git patch of my attempt to bump pyside

diff --git a/flake.lock b/flake.lock
index c312230..51f59f2 100644
--- a/flake.lock
+++ b/flake.lock
@@ -7,11 +7,11 @@
         ]
       },
       "locked": {
-        "lastModified": 1743550720,
-        "narHash": "sha256-hIshGgKZCgWh6AYJpJmRgFdR3WUbkY04o82X05xqQiY=",
+        "lastModified": 1751413152,
+        "narHash": "sha256-Tyw1RjYEsp5scoigs1384gIg6e0GoBVjms4aXFfRssQ=",
         "owner": "hercules-ci",
         "repo": "flake-parts",
-        "rev": "c621e8422220273271f52058f618c94e405bb0f5",
+        "rev": "77826244401ea9de6e3bac47c2db46005e1f30b5",
         "type": "github"
       },
       "original": {
@@ -22,11 +22,11 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1744932701,
-        "narHash": "sha256-fusHbZCyv126cyArUwwKrLdCkgVAIaa/fQJYFlCEqiU=",
+        "lastModified": 1751984180,
+        "narHash": "sha256-LwWRsENAZJKUdD3SpLluwDmdXY9F45ZEgCb0X+xgOL0=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "b024ced1aac25639f8ca8fdfc2f8c4fbd66c48ef",
+        "rev": "9807714d6944a957c2e036f84b0ff8caf9930bc0",
         "type": "github"
       },
       "original": {
diff --git a/flake.nix b/flake.nix
index 3f4a4ed..3ff701b 100644
--- a/flake.nix
+++ b/flake.nix
@@ -33,38 +33,17 @@
               python3Packages = pkgs.python312Packages;
 
               pillow-jxl-plugin = python3Packages.callPackage ./nix/package/pillow-jxl-plugin.nix {
+                inherit python3Packages;
                 inherit (pkgs) cmake;
                 inherit pyexiv2;
               };
-              pyexiv2 = python3Packages.callPackage ./nix/package/pyexiv2.nix { inherit (pkgs) exiv2; };
-              vtf2img = python3Packages.callPackage ./nix/package/vtf2img.nix { };
+              pyexiv2 = python3Packages.callPackage ./nix/package/pyexiv2.nix { inherit (pkgs) exiv2 python3Packages; };
+              vtf2img = python3Packages.callPackage ./nix/package/vtf2img.nix { inherit python3Packages; };
             in
             rec {
               default = tagstudio;
               tagstudio = pkgs.callPackage ./nix/package {
-                # HACK: Remove when PySide6 is bumped to 6.9.x.
-                # Sourced from https://github.com/NixOS/nixpkgs/commit/2f9c1ad5e19a6154d541f878774a9aacc27381b7.
-                pyside6 =
-                  if lib.versionAtLeast python3Packages.pyside6.version "6.9.0" then
-                    (python3Packages.pyside6.override {
-                      shiboken6 = python3Packages.shiboken6.overrideAttrs {
-                        version = "6.8.0.2";
-
-                        src = pkgs.fetchurl {
-                          url = "mirror://qt/official_releases/QtForPython/shiboken6/PySide6-6.8.0.2-src/pyside-setup-everywhere-src-6.8.0.tar.xz";
-                          hash = "sha256-Ghohmo8yfjQNJYJ1+tOp8mG48EvFcEF0fnPdatJStOE=";
-                        };
-
-                        sourceRoot = "pyside-setup-everywhere-src-6.8.0/sources/shiboken6";
-
-                        patches = [ ./nix/package/shiboken6-fix-include-qt-headers.patch ];
-                      };
-                    }).overrideAttrs
-                      { sourceRoot = "pyside-setup-everywhere-src-6.8.0/sources/pyside6"; }
-                  else
-                    python3Packages.pyside6;
-
-                inherit pillow-jxl-plugin vtf2img;
+                inherit pillow-jxl-plugin vtf2img python3Packages;
               };
               tagstudio-jxl = tagstudio.override { withJXLSupport = true; };
 
diff --git a/nix/package/default.nix b/nix/package/default.nix
index a5d6202..7993742 100644
--- a/nix/package/default.nix
+++ b/nix/package/default.nix
@@ -8,7 +8,6 @@
   wrapGAppsHook,
 
   pillow-jxl-plugin,
-  pyside6,
   vtf2img,
 
   withJXLSupport ? false,
@@ -85,6 +84,7 @@ python3Packages.buildPythonApplication {
       pydantic
       pydub
       pyside6
+      shiboken6
       rawpy
       send2trash
       sqlalchemy
diff --git a/nix/package/pillow-jxl-plugin.nix b/nix/package/pillow-jxl-plugin.nix
index 9c8c2fa..7c1dd3f 100644
--- a/nix/package/pillow-jxl-plugin.nix
+++ b/nix/package/pillow-jxl-plugin.nix
@@ -1,5 +1,5 @@
 {
-  buildPythonPackage,
+  python3Packages,
   cmake,
   fetchPypi,
   lib,
@@ -11,7 +11,7 @@
   rustPlatform,
 }:
 
-buildPythonPackage rec {
+python3Packages.buildPythonPackage rec {
   pname = "pillow-jxl-plugin";
   version = "1.3.2";
   pyproject = true;
diff --git a/nix/package/pyexiv2.nix b/nix/package/pyexiv2.nix
index b946e0e..a928785 100644
--- a/nix/package/pyexiv2.nix
+++ b/nix/package/pyexiv2.nix
@@ -1,15 +1,19 @@
 {
   autoPatchelfHook,
-  buildPythonPackage,
+  python3Packages,
   exiv2,
   fetchFromGitHub,
   lib,
 }:
 
-buildPythonPackage rec {
+python3Packages.buildPythonPackage rec {
   pname = "pyexiv2";
   version = "2.15.3";
 
+  pyproject = true;
+
+  build-system = with python3Packages; [ setuptools ];
+
   src = fetchFromGitHub {
     owner = "LeoHsiao1";
     repo = pname;
diff --git a/nix/package/vtf2img.nix b/nix/package/vtf2img.nix
index edfe42d..71d5892 100644
--- a/nix/package/vtf2img.nix
+++ b/nix/package/vtf2img.nix
@@ -1,14 +1,18 @@
 {
-  buildPythonPackage,
+  python3Packages,
   fetchPypi,
   lib,
   pillow,
 }:
 
-buildPythonPackage rec {
+python3Packages.buildPythonPackage rec {
   pname = "vtf2img";
   version = "0.1.0";
 
+  pyproject = true;
+
+  build-system = with python3Packages; [ setuptools ];
+
   src = fetchPypi {
     inherit pname version;
     hash = "sha256-YmWs8673d72wH4nTOXP4AFGs2grIETln4s1MD5PfE0A=";
@@ -16,7 +20,7 @@ buildPythonPackage rec {
 
   pythonImportsCheck = [ "vtf2img" ];
 
-  dependencies = [ pillow ];
+  dependencies = with python3Packages; [ pillow ];
 
   meta = {
     description = "A Python library to convert Valve Texture Format (VTF) files to images.";
diff --git a/nix/shell.nix b/nix/shell.nix
index 22e9d7f..badf573 100644
--- a/nix/shell.nix
+++ b/nix/shell.nix
@@ -5,7 +5,7 @@ let
   # Long term this can be solved with an alternative like uv2nix for the devshell.
   qt6Pkgs = import (builtins.fetchTarball {
     name = "nixos-unstable-qt6-pinned";
-    url = "https://github.com/NixOS/nixpkgs/archive/93ff48c9be84a76319dac293733df09bbbe3f25c.tar.gz";
+    url = "https://github.com/NixOS/nixpkgs/archive/9807714d6944a957c2e036f84b0ff8caf9930bc0.tar.gz";
     sha256 = "038m7932v4z0zn2lk7k7mbqbank30q84r1viyhchw9pcm3aq3q23";
   }) { inherit (pkgs) system; };
 
diff --git a/pyproject.toml b/pyproject.toml
index c173364..5ecdf45 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,7 +21,7 @@ dependencies = [
     "pillow-jxl-plugin~=1.3",
     "pydantic~=2.10",
     "pydub~=0.25",
-    "PySide6==6.8.0.*",
+    "PySide6==6.9.1",
     "rawpy~=0.24",
     "Send2Trash~=1.8",
     "SQLAlchemy~=2.0",
diff --git a/src/tagstudio/qt/ts_qt.py b/src/tagstudio/qt/ts_qt.py
index 8a2de8e..1209f06 100644
--- a/src/tagstudio/qt/ts_qt.py
+++ b/src/tagstudio/qt/ts_qt.py
@@ -94,6 +94,8 @@ from tagstudio.qt.widgets.panel import PanelModal
 from tagstudio.qt.widgets.progress import ProgressWidget
 from tagstudio.qt.widgets.thumb_renderer import ThumbRenderer
 
+import importlib
+
 BADGE_TAGS = {
     BadgeType.FAVORITE: TAG_FAVORITE,
     BadgeType.ARCHIVED: TAG_ARCHIVED,
@@ -209,7 +211,7 @@ class QtDriver(DriverMixin, QObject):
         self.selected: list[int] = []  # Selected Entry IDs
 
         self.SIGTERM.connect(self.handle_sigterm)
-
+        logger.warning(f"[] using QT and pyside version of {importlib.metadata.version('pyside6')}")
         self.global_settings_path = DEFAULT_GLOBAL_SETTINGS_PATH
         if self.args.settings_file:
             self.global_settings_path = Path(self.args.settings_file)

[CommentatorForAll]

How does one create those collapsable thingys? that way this patch isn't taking up everything...

[xarvex]

Yeah, an updated PySide and Qt would mean the overrides that are done in the flake can be removed entirely, and the existing packages in nixpkgs are used. The complexity and why this is taking time to be addressed is that the project itself may have breakage in updating. It may be the best path forward, though.

For that, I'm calling in @CyanVoxel.

Also, here is the section on the collapsible sections, the example even includes a code block.