Skip to content

Latest commit

 

History

History
89 lines (62 loc) · 3.01 KB

README.md

File metadata and controls

89 lines (62 loc) · 3.01 KB
Raw

Project Icon

GNOME Shell Extension: Containers

Manage Linux containers seamlessly using Podman within the GNOME Shell.

GitHub stars
GitHub issues

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.

From Source 📂

  1. Clone the repository:

    git clone https://github.com/rgolangh/gnome-shell-extension-containers
cd gnome-shell-extension-containers

  2. Build and install:

make all
  1. Enable the extension:
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:

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 📸

Project Icon

License 📜

Apache-2.0 License