What is an Extension¶
Ulauncher extensions are Python 2 programs that run as separate processes along with the app.
When you run Ulauncher it starts all available extensions so they are ready to react to user events. All extensions are terminated when Ulauncher app is closed or crashed.
What Extensions Can Do¶
Extensions have the same capabilities as any other program – they can access your directories, make network requests, etc. Basically they get the same rights as a user that runs Ulauncher.
Extension API v1 (current) enables extension developers to write custom handlers for keywords.
With Extension API it is possible to capture event when user enters “ti<Space>” into the input and then render any results bellow the input box.
Extensions can define preferences in
manifest.json that can be overridden by a user
from Ulauncher Preferences window.
Preferences UI is not implemented yet
It is also possible to capture item click (enter) event and run a custom function to respond to that event.
Ulauncher ⇄ Extension Communication Layer¶
Ulauncher communicates to extensions using WebSockets.
For developer convenience there is an abstraction layer over WebSockets that reduces amount of boilerplate code in extensions.