awesome-wm-widgets

History

b0wter f190f1370f Fixed issue with wrong icon for containers that never started		2023-05-12 08:57:05 +02:00
..
icons	[docker] add a delete button	2020-11-23 17:12:30 -05:00
README.md	Changed value in README.md to reflect the default value	2023-04-23 23:03:47 +02:00
docker.gif	[docker] update readme	2020-08-17 17:00:55 -04:00
docker.lua	Fixed issue with wrong icon for containers that never started	2023-05-12 08:57:05 +02:00

README.md

The widget allows to manage docker and podman containers, namely start/stop/pause/unpause:

Customization

It is possible to customize widget by providing a table with all or some of the following config parameters:

Name	Default	Description
`icon`	`./docker-widget/icons/docker.svg`	Path to the icon
`number_of_containers`	`-1`	Number of last created containers to show
`executable_name`	`docker`	Name of the executable to use, defaults to `docker`
`max_widget_width`	270	Maximum width of the widget before the text breaks

The executable_name allows you to use Podman instead of docker. This works since Podman is compatible to docker in the sense that the syntax and command outputs are identical.

Installation

Clone the repo under ~/.config/awesome/ and add widget in rc.lua:

local docker_widget = require("awesome-wm-widgets.docker-widget.docker")
...
s.mytasklist, -- Middle widget
	{ -- Right widgets
    	layout = wibox.layout.fixed.horizontal,
        ...
        -- default
        docker_widget(),
        -- customized
        docker_widget{
            number_of_containers = 5
        },

README.md

Docker / Podman Widget

Customization

Installation