brpaz / ulauncher-docker

Manage your Docker containers from Ulauncher

ulauncher-docker

Manage your Docker containers from Ulauncher

Demo

Features

• Lists all running Docker containers
• Display container name, image, ip and exposed ports.
• Allow executing common actions on containers like tailing logs, open a shell, start, stop and restart.
• And more

Requirements

• Ulauncher 5
• Python >= 3
• Docker daemon running on your machine

This extension also needs docker-py.

To install it, after installing the extension, run the following command on your terminal:

cd ~/.local/share/ulauncher/extensions/com.github.brpaz.ulauncher-docker
pip3 install -r requirementx.txt

Install

Open ulauncher preferences window -> extensions -> add extension and paste the following url:

https://github.com/brpaz/ulauncher-docker

Usage

On Ulauncher, type Docker to see the available commands:

Development

git clone https://github.com/brpaz/ulauncher-docker
make link

The make link command will symlink the cloned repo into the appropriate location on the ulauncher extensions folder.

To see your changes, stop ulauncher and run it from the command line with: ulauncher -v.

Contributing

Contributions, issues and Features requests are welcome.

Show your support

License

Copywright @ 2019 Bruno Paz

This project is MIT Licensed.

ulauncher-docker's Issues

"x-terminal-emulator" not always available on the system

Whenever the extension is opening a terminal, it runs "x-terminal-emulator". In my case (opensuse leap), this resolves to nothing.

Of course a quick workaround is to create a symlink that points 'x-terminal-emulator' to your preferred terminal emulator, for example:
ln -s $(which tilix) /usr/local/x-terminal-emulator

Nevertheless, there should be an option in the settings to specify your preferred app, or even a check at install to verify that something answers to that name in the path, and if not, take action to solve the problem... If no action is taken, this should be documented somewhere (hence this issue)

[Feature Request]: Default terminal add xfce4-terminal

Descprition?

Hello,
What would be the way to add xfce4-terminal to the Default terminal selection?
Thank you

Container shell option

Can you please add an option to choose container shell? Many containers has bash support, it's not cool to type "bash" every time.

[Bug]: I got extension crashed on ubuntu 22.04

Description?

1. provide url for downloading ulaucher-docker plugin
2. save upon completion
3. install required python3 package as instructed
4. try using the extension
   Screencast from 04-17-2024 08:05:19 PM.webm

Extension Logs

No response

Error when saving extension and no dk working

First of all thank you for your extension 👍

I have a problem when I try to add your extension, I got an error and even if I click save and go back to the launcher I still can use "dk".

I have installed python + the extension you said in your readme and still having the same message.

"Unexpected API error. KeyError: com.github.brpaz.ulauncher-docker"

Some information about my configuration:

OS: Ubuntu 18.10
Last ulauncher version
pip version 9.0.1 and python 2.7
Docker: CE 18.09

Can't install extension

Description?

Hey, I was using this extension and it was running smooth.But in other machine with the same installation, I can't install the plugin.

Docker is installed already.

Extension Logs

ulauncher -v --dev |& grep ulauncher-docker
2023-10-27 08:47:41,337 | INFO | ulauncher.api.server.ExtensionRunner: _run_process() | Extension "com.github.brpaz.ulauncher-docker" started. PID 7170
2023-10-27 08:47:42,133 | ERROR | ulauncher.api.server.ExtensionRunner: _run_process() | Extension "com.github.brpaz.ulauncher-docker" exited instantly with code 1
2023-10-27 08:47:42,133 | ERROR | ulauncher.api.server.ExtensionRunner: _run_process() | Extension "com.github.brpaz.ulauncher-docker" failed with an error: ModuleNotFoundError: No module named 'docker'
  File "/home/carlos/.local/share/ulauncher/extensions/com.github.brpaz.ulauncher-docker/main.py", line 6, in <module>
  File "/home/carlos/.local/share/ulauncher/extensions/com.github.brpaz.ulauncher-docker/dk/extension.py", line 8, in <module>

unable to add docker extension

Message: 'com.github.brpaz.ulauncher-docker'
Error Name: UnhandledError
Type: KeyError

Stacktrace:

Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/ulauncher/ui/windows/PreferencesUlauncherDialog.py", line 192, in on_scheme_callback
    resp = rt.dispatch(self, scheme_request.get_uri())
  File "/usr/lib/python3/dist-packages/ulauncher/utils/Router.py", line 49, in dispatch
    return callback(context, url_params)
  File "/usr/lib/python3/dist-packages/ulauncher/ui/windows/PreferencesUlauncherDialog.py", line 411, in prefs_extension_update_prefs
    controller = ExtensionServer.get_instance().get_controller(ext_id)
  File "/usr/lib/python3/dist-packages/ulauncher/api/server/ExtensionServer.py", line 76, in get_controller
    return self.controllers[extension_id]
KeyError: 'com.github.brpaz.ulauncher-docker'

I cant add unexpected api

Hi, this is the error when I tried to add to my ulauncher 4.4.0 rc1 (ubuntu 18.04)

Unexpected API error. HTTPError:
Cancel
Add

Crash

Hi, it crashes on latest beta.