Fix syncthing plugin #223

ngencokamin · 2025-07-03T18:01:16Z

Syncthing wasn't working properly. Was throwing errors about st not being defined any time the user types in albert, and the error [crit:albert.python] Unable to cast Python instance of type <class 'NoneType'> to C++ type 'QString' when opening settings, displaying a blank window instead of the api key field. This PR:

Adds handling to make sure the api key is never None type, fixing the settings issue
Adds handling for missing and invalid api keys
- Shows distinct messages for each scenarios

Screenshots

Valid api key

Invalid api key

No api key

ngencokamin · 2025-07-08T17:33:10Z

I reverted my changes on lines 58-64. I'd changed them while experimenting with why settings was broken and forgot to revert. As an aside, as far as I can tell the option does nothing, but I added it back just to avoid changing anything I didn't need to.

ngencokamin · 2025-07-08T18:47:28Z

Oh forgot to include, here's a before and after of the settings menu

ManuelSchneid3r · 2025-07-12T07:51:57Z

@ngencokamin lets continue the discussion here. what have you changed to make the config widget work?

ngencokamin · 2025-07-12T19:27:59Z

@ngencokamin lets continue the discussion here. what have you changed to make the config widget work?

Hey sorry for the slow reply, been crazy busy with work. Lemme run through and break down my changes and why I made them/what they do

ngencokamin

Here's a lil breakdown of the code choices I made! Sorry it took so long 😭

ngencokamin · 2025-07-12T19:28:47Z

syncthing/__init__.py

@@ -22,14 +22,16 @@

 class Plugin(PluginInstance, GlobalQueryHandler):

-    config_key = 'syncthing_api_key'
+    config_key = 'api_key'


This is to make the config key consistent with references throughout the rest of the script

ngencokamin · 2025-07-12T19:33:08Z

syncthing/__init__.py

+        if self._api_key is None:
+            self._api_key = ''


This fixes the widget not appearing with error 12:26:44 [crit:albert.python] Unable to cast Python instance of type <class 'NoneType'> to C++ type 'QString'

Basically just initializes api_key to an empty string if an api key isn't found in the config. Otherwise it breaks because of it being None/null

ngencokamin · 2025-07-12T19:33:28Z

syncthing/__init__.py

@@ -39,6 +41,7 @@ def defaultTrigger(self):
    @property
    def api_key(self) -> str:
        return self._api_key
+        # return '1234'


I didn't mean to leave this in and will make a commit removing it

Okay, this is fixed now

ngencokamin · 2025-07-12T19:34:50Z

syncthing/__init__.py

+        try:
+            if self.st:
+                config = self.st.system.config()
+
+                devices = dict()
+                for d in config['devices']:
+                    if not d['name']:
+                        d['name'] = d['deviceID']
+                    d['_shared_folders'] = {}
+                    devices[d['deviceID']] = d
+
+                folders = dict()
+                for f in config['folders']:
+                    if not f['label']:
+                        f['label'] = f['id']
+                    for d in f['devices']:
+                        devices[d['deviceID']]['_shared_folders'][f['id']] = f
+                    folders[f['id']] = f
+
+                matcher = Matcher(query.string)
+
+                # create device items
+                for device_id, d in devices.items():
+                    device_name = d['name']
+
+                    if match := matcher.match(device_name):
+                        device_folders = ", ".join([f['label'] for f in d['_shared_folders'].values()])
+
+                        actions = []
+                        if d['paused']:
+                            actions.append(
+                                Action("resume", "Resume synchronization",
+                                    lambda did=device_id: self.st.system.resume(did))
+                            )
+                        else:
+                            actions.append(
+                                Action("pause", "Pause synchronization",
+                                    lambda did=device_id: self.st.system.pause(did))
+                            )
+
+                        item = StandardItem(
+                            id=device_id,
+                            text=f"{device_name}",
+                            subtext=f"{'Paused ' if d['paused'] else ''}Syncthing device. "
+                                    f"Shared: {device_folders if device_folders else 'Nothing'}.",
+                            iconUrls=self.iconUrls,
+                            actions=actions
                        )

+                        results.append(RankItem(item, match))
+
+                # create folder items
+                for folder_id, f in folders.items():
+                    folder_name = f['label']
+                    if match := matcher.match(folder_name):
+                        folders_devices = ", ".join([devices[d['deviceID']]['name'] for d in f['devices']])
+                        item = StandardItem(
+                            id=folder_id,
+                            text=folder_name,
+                            subtext=f"Syncthing folder {f['path']}. "
+                                    f"Shared with {folders_devices if folders_devices else 'nobody'}.",
+                            iconUrls=self.iconUrls,
+                            actions=[
+                                Action("scan", "Scan the folder",
+                                    lambda fid=folder_id: self.st.database.scan(fid)),
+                                Action("open", "Open this folder in file browser",
+                                    lambda p=f['path']: openFile(p))
+                            ]
+                        )
+                        results.append(RankItem(item, match))


This bit try is meant to catch it when syncthing fails to initialize due to missing or invalid api key. Otherwise it spits errors with every character entered into the launcher. Plus, having it blank with no explanation outside of the console is not the most friendly design.

I maybe could do the try except only around the bit that checks if st is initialized/valid? So that it's a little less general

ngencokamin · 2025-07-12T19:39:05Z

syncthing/__init__.py

+                if self._api_key == '':
                    item = StandardItem(
-                        id=device_id,
-                        text=f"{device_name}",
-                        subtext=f"{'Paused ' if d['paused'] else ''}Syncthing device. "
-                                f"Shared: {device_folders if device_folders else 'Nothing'}.",
-                        iconUrls=self.iconUrls,
-                        actions=actions
+                        id="no_key",
+                        text="Please enter your Syncthing API key in settings",
+                        subtext="You can find your api key on your Syncthing web dashboard.",
+                        iconUrls=self.iconUrls
                    )
-
-                    results.append(RankItem(item, match))
-
-            # create folder items
-            for folder_id, f in folders.items():
-                folder_name = f['label']
-                if match := matcher.match(folder_name):
-                    folders_devices = ", ".join([devices[d['deviceID']]['name'] for d in f['devices']])
+                else:
                    item = StandardItem(
-                        id=folder_id,
-                        text=folder_name,
-                        subtext=f"Syncthing folder {f['path']}. "
-                                f"Shared with {folders_devices if folders_devices else 'nobody'}.",
-                        iconUrls=self.iconUrls,
-                        actions=[
-                            Action("scan", "Scan the folder",
-                                   lambda fid=folder_id: self.st.database.scan(fid)),
-                            Action("open", "Open this folder in file browser",
-                                   lambda p=f['path']: openFile(p))
-                        ]
+                        id="invalid_key",
+                        text='Invalid API Key',
+                        subtext=f"API Key {self._api_key} is invalid. Please try entering your API key again in settings.",
+                        iconUrls=self.iconUrls
                    )
-                    results.append(RankItem(item, match))
-
+                results.append(RankItem(item, 0))


So in theory, this except should only fire if the api key is invalid or missing. But I can see how we might want the logic to be a little less broad. Basically rn it just checks if the key is blank, at which point it reports missing, else it reports invalid.

ngencokamin · 2025-07-12T19:42:24Z

@ngencokamin lets continue the discussion here. what have you changed to make the config widget work?

Hey sorry for the slow reply, been crazy busy with work. Lemme run through and break down my changes and why I made them/what they do

@ngencokamin lets continue the discussion here. what have you changed to make the config widget work?

Oh I can also add better code comments if that'd be helpful

ngencokamin added 2 commits July 3, 2025 12:56

Fix syncthing

ed8737a

Revert settings label change, tooltip

2567b33

ngencokamin commented Jul 12, 2025

View reviewed changes

Remove unused code for debugging that I accidentally left in

e872882

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Fix syncthing plugin #223

Fix syncthing plugin #223

Uh oh!

ngencokamin commented Jul 3, 2025

Uh oh!

ngencokamin commented Jul 8, 2025

Uh oh!

ngencokamin commented Jul 8, 2025

Uh oh!

ManuelSchneid3r commented Jul 12, 2025

Uh oh!

ngencokamin commented Jul 12, 2025

Uh oh!

ngencokamin left a comment

Uh oh!

ngencokamin Jul 12, 2025

Uh oh!

ngencokamin Jul 12, 2025

Uh oh!

ngencokamin Jul 12, 2025

Uh oh!

ngencokamin Jul 12, 2025

Uh oh!

ngencokamin Jul 12, 2025

Uh oh!

ngencokamin Jul 12, 2025

Uh oh!

ngencokamin Jul 12, 2025

Uh oh!

ngencokamin commented Jul 12, 2025

Uh oh!

Uh oh!

Uh oh!

Fix syncthing plugin #223

Are you sure you want to change the base?

Fix syncthing plugin #223

Uh oh!

Conversation

ngencokamin commented Jul 3, 2025

Uh oh!

ngencokamin commented Jul 8, 2025

Uh oh!

ngencokamin commented Jul 8, 2025

Uh oh!

ManuelSchneid3r commented Jul 12, 2025

Uh oh!

ngencokamin commented Jul 12, 2025

Uh oh!

ngencokamin left a comment

Choose a reason for hiding this comment

Uh oh!

ngencokamin Jul 12, 2025

Choose a reason for hiding this comment

Uh oh!

ngencokamin Jul 12, 2025

Choose a reason for hiding this comment

Uh oh!

ngencokamin Jul 12, 2025

Choose a reason for hiding this comment

Uh oh!

ngencokamin Jul 12, 2025

Choose a reason for hiding this comment

Uh oh!

ngencokamin Jul 12, 2025

Choose a reason for hiding this comment

Uh oh!

ngencokamin Jul 12, 2025

Choose a reason for hiding this comment

Uh oh!

ngencokamin Jul 12, 2025

Choose a reason for hiding this comment

Uh oh!

ngencokamin commented Jul 12, 2025

Uh oh!

Uh oh!