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

Manage your Docker containers from Ulauncher
https://github.com/brpaz/ulauncher-docker

docker ulauncher ulauncher-extension

Last synced: 12 months ago
JSON representation

Manage your Docker containers from Ulauncher

• Host: GitHub
• URL: https://github.com/brpaz/ulauncher-docker
• Owner: brpaz
• License: mit
• Created: 2019-02-03T15:12:52.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-09-11T06:48:39.000Z (almost 3 years ago)
• Last Synced: 2024-05-02T05:58:54.670Z (about 2 years ago)
• Topics: docker, ulauncher, ulauncher-extension
• Language: Python
• Homepage: https://ext.ulauncher.io/-/github-brpaz-ulauncher-docker
• Size: 3.48 MB
• Stars: 23
• Watchers: 3
• Forks: 8
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# ulauncher-docker

> Manage your Docker containers from Ulauncher

[![Ulauncher Extension](https://img.shields.io/badge/Ulauncher-Extension-green.svg?style=for-the-badge)](https://ext.ulauncher.io/-/github-brpaz-ulauncher-docker)

[![CI Status](https://img.shields.io/github/workflow/status/brpaz/ulauncher-docker/CI?color=orange&label=actions&logo=github&logoColor=orange&style=for-the-badge)](https://github.com/brpaz/ulauncher-docker/workflows)

![License](https://img.shields.io/github/license/brpaz/ulauncher-docker.svg?style=for-the-badge)

## Demo

![Demo](demo.gif)

## 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](https://github.com/docker/docker-py).

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

```bash

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:

![Extension Commands](./assets/screenshots/extension_demo.png)

## 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](https://github.com/brpaz)

This project is [MIT](LLICENSE) Licensed.