For developers

Useful debugging tips

# Enable all albert logs of a particular plugin
QT_LOGGING_RULES='albert.python*=true' albert

# Enable _all_ albert logs
QT_LOGGING_RULES='albert*=true' albert

# Enable _all_ logs (albert + qt)
QT_LOGGING_RULES='*=true' albert

# Enable _all_ logs (albert + qt) with additional plugin debug info
QT_LOGGING_RULES='*=true' QT_DEBUG_PLUGINS=1 albert

Best practices

How to version plugins

If it has a public API major.minor.patch else minor.patch. Increase major if the API breaks. Increase minor if the API got some backward compatible additions or the user experiences noticable changes. In all other cases increase patch.

Avoiding name conflicts of extension identifiers

If your plugin provides multiple extensions it's a good idea to prepend the plugin id to the extension id to avoid name conflicts of extensions, e.g. files.root_browser. The root extension is fine to match the plugin id.