{"id":28609923,"url":"https://github.com/ignis-sh/ignis","last_synced_at":"2025-06-11T22:07:38.079Z","repository":{"id":250897012,"uuid":"834792716","full_name":"ignis-sh/ignis","owner":"ignis-sh","description":"A widget framework for building desktop shells, written and configurable in Python","archived":false,"fork":false,"pushed_at":"2025-06-10T20:03:27.000Z","size":10054,"stargazers_count":429,"open_issues_count":34,"forks_count":28,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-10T20:39:01.946Z","etag":null,"topics":["desktop-environment","gtk4","ignis","linux-desktop","python","unixporn","wayland","widget"],"latest_commit_sha":null,"homepage":"https://ignis-sh.github.io/ignis/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ignis-sh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-07-28T11:31:25.000Z","updated_at":"2025-06-10T19:34:25.000Z","dependencies_parsed_at":"2024-08-01T18:29:19.045Z","dependency_job_id":"4c7ecf89-14b9-4a56-94ba-4f305598fda8","html_url":"https://github.com/ignis-sh/ignis","commit_stats":{"total_commits":220,"total_committers":5,"mean_commits":44.0,"dds":0.031818181818181857,"last_synced_commit":"70aafb13b3722afba89c27fc8166d088cd53b117"},"previous_names":["linkfrg/ignis","ignis-sh/ignis"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/ignis-sh/ignis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ignis-sh%2Fignis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ignis-sh%2Fignis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ignis-sh%2Fignis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ignis-sh%2Fignis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ignis-sh","download_url":"https://codeload.github.com/ignis-sh/ignis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ignis-sh%2Fignis/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259352879,"owners_count":22844740,"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","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":["desktop-environment","gtk4","ignis","linux-desktop","python","unixporn","wayland","widget"],"created_at":"2025-06-11T22:02:08.807Z","updated_at":"2025-06-11T22:07:38.067Z","avatar_url":"https://github.com/ignis-sh.png","language":"Python","readme":"# Ignis\n\n[![docs](https://github.com/ignis-sh/ignis/actions/workflows/latest_docs.yaml/badge.svg)](https://github.com/ignis-sh/ignis/actions/workflows/latest_docs.yaml)\n[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Linting: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\nA widget framework for building desktop shells, written and configurable in Python.\n\n- Easy to use\n- GTK4-based\n- Batteries Included (a lot of built-in Services and Utilities!)\n- Flexible work with widgets\n\n\u003e [!NOTE]\n\u003e Ignis is mostly stable, but still a work in progress.\n\u003e The API is a subject to change.\n\u003e\n\u003e The breaking changes tracker is available in [#60](https://github.com/ignis-sh/ignis/issues/60)\n\n## Getting started\nSee the [Documentation](https://ignis-sh.github.io/ignis)\n\n## Supported Desktops\n- wlroots-based Wayland compositors (e.g., __Sway__) \n- __Hyprland__\n- Smithay based compositors (e.g., __COSMIC__)\n- __KDE Plasma__ on wayland\n\n...and all other compositors that implement the Layer Shell protocol.\n\nIgnis __is not supported__ on:\n- GNOME Wayland\n- X11\n\n...because they don't support the Layer Shell protocol.\n\n## Examples\n* A simple bar, see [examples](./examples/bar)\n![simple-bar](./examples/bar/simple-bar.png)\n\n* [My own configuration](https://github.com/linkfrg/dotfiles/)\n![My own configuration](https://github.com/linkfrg/dotfiles/blob/main/assets/1.png?raw=true)\n\n## Contributing\nCheck out the [Developer Guide](https://ignis-sh.github.io/ignis/latest/dev/index.html)\n\n## Licensing\nIgnis is licensed under the __LGPL-2.1-or-later__.\n\n## Special Thanks\n[AGS](https://github.com/aylur/ags) - for inspiration\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fignis-sh%2Fignis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fignis-sh%2Fignis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fignis-sh%2Fignis/lists"}