{"id":31524624,"url":"https://github.com/dragon-elec/z-manager","last_synced_at":"2026-05-17T17:10:42.671Z","repository":{"id":310013429,"uuid":"1037883074","full_name":"dragon-Elec/z-manager","owner":"dragon-Elec","description":"🔧 Modern GTK4 GUI for ZRAM management on Linux - Configure compression, swap priority \u0026 monitor performance","archived":false,"fork":false,"pushed_at":"2025-10-01T18:44:06.000Z","size":289,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-01T19:24:04.586Z","etag":null,"topics":["compression","desktop-application","gtk","linux-gui","linux-tools","memory-management","performance-tools","python","ram-management","swap-management","system-monitor","system-tools","zram","zram-generator"],"latest_commit_sha":null,"homepage":"https://github.com/dragon-Elec/z-manager","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dragon-Elec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-14T09:13:19.000Z","updated_at":"2025-10-01T18:44:10.000Z","dependencies_parsed_at":"2025-08-15T07:09:45.162Z","dependency_job_id":"72e4db9e-09a6-4540-8ba3-dc983eebd2d9","html_url":"https://github.com/dragon-Elec/z-manager","commit_stats":null,"previous_names":["dragon-elec/z-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dragon-Elec/z-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragon-Elec%2Fz-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragon-Elec%2Fz-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragon-Elec%2Fz-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragon-Elec%2Fz-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dragon-Elec","download_url":"https://codeload.github.com/dragon-Elec/z-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragon-Elec%2Fz-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278197489,"owners_count":25946571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["compression","desktop-application","gtk","linux-gui","linux-tools","memory-management","performance-tools","python","ram-management","swap-management","system-monitor","system-tools","zram","zram-generator"],"created_at":"2025-10-03T17:33:27.438Z","updated_at":"2026-05-17T17:10:42.664Z","avatar_url":"https://github.com/dragon-Elec.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Z-Manager\n\n## A Modern GTK4 / Libadwaita GUI for Managing ZRAM on Linux.\n\n[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)\n\n\u003e **⚠️ Alpha Software**\n\u003e\n\u003e This application is in early development. You may encounter bugs, incomplete features, or unexpected behavior. Please test on a non-critical system and [report any issues](https://github.com/dragon-Elec/z-manager/issues) you find.\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch3\u003e📊 Main Dashboard\u003c/h3\u003e\n  \u003cimg src=\"./images/status_tab.png\" alt=\"Status Dashboard\" width=\"600\"/\u003e\n  \u003cp\u003e\u003ci\u003eMonitor active ZRAM devices and system swap priority in real-time.\u003c/i\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003chr/\u003e\n\n### 🚀 Performance \u0026 Memory\n| **Hibernate Management** | **System Tuning** |\n|:---:|:---:|\n| \u003cimg src=\"./images/hibernate_tab.png\" alt=\"Hibernate\" width=\"380\"/\u003e | \u003cimg src=\"./images/tune_tab.png\" alt=\"Tune\" width=\"380\"/\u003e |\n| *Manage persistent storage for kernel resumption.* | *Real-time tuning of kernel parameters and PSI monitoring.* |\n\n### ⚙️ Expert Configuration\n| **Presets \u0026 Profiles** | **Advanced Settings** |\n|:---:|:---:|\n| \u003cimg src=\"./images/configure_tab_profiles.png\" alt=\"Profiles\" width=\"380\"/\u003e | \u003cimg src=\"./images/configure_tab_settings.png\" alt=\"Settings\" width=\"380\"/\u003e |\n| *Fast, one-click optimization for gaming or servers.* | *Fine-grained control over the ZRAM generator parameters.* |\n\n### 🛠️ Diagnostics \u0026 Logs\n| **System Health** | **Journal Insight** |\n|:---:|:---:|\n| \u003cimg src=\"./images/health_report_details.png\" alt=\"Health\" width=\"380\"/\u003e | \u003cimg src=\"./images/system_logs_view.png\" alt=\"Logs\" width=\"380\"/\u003e |\n| *Deep-dive into your system's swap health status.* | *Integrated viewer for ZRAM-specific systemd logs.* |\n\n\u003cbr/\u003e\n\n## About The Project\n\nZ-Manager is a user-friendly desktop application designed to simplify the configuration and monitoring of ZRAM on modern Linux systems. It acts as a graphical frontend for `zram-generator` and the underlying kernel subsystem, providing a clean interface for tasks that traditionally require the command line.\n\nThis tool is for desktop users and system tweakers who want to harness the performance benefits of ZRAM without the command-line hassle.\n\n## Features\n\n* **Easy Configuration:** Configure ZRAM size, compression algorithm, and swap priority through a simple interface.\n* **Advanced Settings:** Manage advanced `zram-generator` options like writeback devices, filesystem mode, and host memory limits.\n* **Configuration Profiles:** Use built-in profiles (e.g., \"Desktop / Gaming\") for quick and optimized setups.\n* **Live Monitoring:** View real-time statistics for active ZRAM devices, including usage, compression ratio, and memory statistics.\n* **System Health:** Get a clear overview of your entire system's swap configuration and diagnose potential conflicts (like an active ZSwap).\n* **System Tuning:** Adjust related kernel parameters like CPU governors and I/O schedulers to further optimize performance.\n* **Log Viewer:** Easily view ZRAM-related logs from the systemd journal to troubleshoot issues.\n\n## Requirements\n\n* Python 3.11+\n* GTK 4\n* libadwaita 1.x\n* `systemd` with `zram-generator`\n* `psutil`\n\n## Project Structure\n\n```\nz-manager/\n├── core/                    # Backend logic\n│   ├── device_management/   # Modular device orchestration\n│   │   ├── prober.py        #   Device discovery \u0026 status queries\n│   │   ├── configurator.py  #   Apply/remove device \u0026 global config\n│   │   ├── provisioner.py   #   Device creation \u0026 sysfs management\n│   │   └── types.py         #   Shared dataclasses (DeviceInfo, etc.)\n│   ├── boot_config.py       # GRUB / bootloader kernel param management\n│   ├── config.py            # zram-generator INI config reader\n│   ├── config_writer.py     # zram-generator INI config writer\n│   ├── health.py            # System health diagnostics\n│   ├── hibernate_ctl.py     # Hibernation / resume management\n│   └── os_utils.py          # Low-level sysfs \u0026 subprocess helpers\n├── modules/                 # Auxiliary services\n│   ├── monitoring.py        # Real-time polling engine\n│   └── journal.py           # Systemd journal log reader\n├── ui/                      # GTK4 / Libadwaita frontend\n│   ├── status_page.py       # Main dashboard\n│   ├── configure_page.py    # Configuration UI\n│   ├── configure_logic.py   # Configuration business logic\n│   ├── live_orchestrator.py # Live-apply orchestration\n│   ├── log_viewer.py        # Log viewer dialog\n│   └── custom_widgets/      # Reusable widgets (CircularWidget, etc.)\n└── tests/                   # Test suite\n    ├── test_base.py          # Shared base class \u0026 assertions\n    ├── unit/                 # Unit tests\n    └── integration/          # Integration tests\n```\n\n## Installation\n\nInstallation instructions will be provided once the application reaches a more stable release.\n\n## Contributing\n\nContributions are welcome and greatly appreciated! This project is developed by an individual, and community involvement can help make it better.\n\nIf you are interested in contributing, please feel free to:\n* **Open an Issue:** Report bugs, suggest new features, or ask questions.\n* **Submit a Pull Request:** If you'd like to contribute code, please open an issue first to discuss the proposed changes.\n\nYou can find the issue tracker on the project's GitHub page:\n[https://github.com/dragon-Elec/z-manager/issues](https://github.com/dragon-Elec/z-manager/issues)\n\n## License\n\nThis project is licensed under the **GNU General Public License v2.0**. See the `LICENSE` file for the full license text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragon-elec%2Fz-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdragon-elec%2Fz-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragon-elec%2Fz-manager/lists"}