Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rgolangh/gnome-shell-extension-containers
containers is a gnome-shell extension to manage linux container, run by podman
https://github.com/rgolangh/gnome-shell-extension-containers
containers gnome podman
Last synced: 15 days ago
JSON representation
containers is a gnome-shell extension to manage linux container, run by podman
- Host: GitHub
- URL: https://github.com/rgolangh/gnome-shell-extension-containers
- Owner: rgolangh
- License: apache-2.0
- Created: 2018-10-28T14:37:44.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-10-16T08:15:28.000Z (3 months ago)
- Last Synced: 2024-12-09T11:10:34.008Z (25 days ago)
- Topics: containers, gnome, podman
- Language: JavaScript
- Homepage:
- Size: 1.53 MB
- Stars: 48
- Watchers: 5
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome_atomic - gnome-shell-extension-containers - This neat extension lets you see what containers you have, start/stop/restart, pause, and shell into them right from the notification area. (Core Tools)
README
# GNOME Shell Extension: Containers
**Manage Linux containers seamlessly using Podman within the GNOME Shell.**
## Features ✨
This extension provides a convenient GNOME Shell menu to manage your Podman containers. Supported actions include:
- **Start**: Initialize containers. 🚀
- **Stop**: Terminate running containers. 🛑
- **Remove**: Delete containers. 🗑️
- **Pause**: Suspend container processes. ⏸️
- **Restart**: Reboot containers. 🔄
- **Top Resources**: Display resource usage stats. 📊
- **Shell Access**: Open a terminal shell in the container. 🔧
- **Live Stats**: View real-time statistics in a new terminal. 📈
- **Logs Monitoring**: Follow logs in a new terminal session. 📋
- **Inspect Info**: View and copy detailed inspection information. 🔍
## Installation 🛠️
### From GNOME Extensions Page 🌐
You can install this extension directly from the [GNOME Extensions page](https://extensions.gnome.org/extension/1500/containers/).
### From Source 📂
1. **Clone the repository:**
```bash
git clone https://github.com/rgolangh/gnome-shell-extension-containers
cd gnome-shell-extension-containers
```
2. Build and install:
```bash
make all
```
3. Enable the extension:
```bash
make enable
```
Alternatively, enable it via Extensions -> Toggle 'Containers'.
## Preferences ⚙
- __*extra-info*__
Show information about the container, see the screenshot
- __*terminal*__
The terminal program to use when performing the `Show Logs`, `Watch Top`, `Open Shell`, and `Watch Statistics`
Tested values:
| value | notes |
| ----- | ----- |
|__*gnome-terminal --*__| default terminal program for all gnome version till 46, inclusive |
|__*ptyxis --*__| default terminal program for gnome version from 47 onward |
|__*kitty*__| no extra arguments needed |
|__*flatpak run app.studiodev.Ptyxis --*__| Some flatpak environments doesn't have podman on the path |
|__*flatpak run com.gexperts.Tilix -e*__| Some flatpak environments doesn't have podman on the path |
Note: The value for __*terminal*__ may not work for you. Please report any working value you have so in time we would have a proper list.
There is a system wide gsettings `org.gnome.desktop.default-applications.terminal exec` but depending on the value different args are needed, as seen from above.
## Development / Contributing 🤝
To contribute to the development of this extension:
Clone the repository and make your changes.
Debugging: Spin up an inline GNOME Shell session in a dedicated window:
```bash
make debug
```
Contributions are welcome! Please ensure your code follows the project’s style guidelines and is thoroughly tested before submitting a pull request.
## Screenshot 📸
## License 📜
Apache-2.0 License