https://github.com/Aylur/ags

A customizable and extensible shell
https://github.com/Aylur/ags

desktop-environment gtk3 unixporn wayland

Last synced: 3 days ago
JSON representation

A customizable and extensible shell

• Host: GitHub
• URL: https://github.com/Aylur/ags
• Owner: Aylur
• License: gpl-3.0
• Created: 2023-06-24T14:19:48.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-01T18:07:04.000Z (8 days ago)
• Last Synced: 2024-11-01T19:18:18.291Z (8 days ago)
• Topics: desktop-environment, gtk3, unixporn, wayland
• Language: TypeScript
• Homepage:
• Size: 870 KB
• Stars: 2,221
• Watchers: 14
• Forks: 116
• Open Issues: 90
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/Aylur/ags - Linux Wayland desktop widgets (Jump To / Customizations)
• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/Aylur/ags - Linux Wayland desktop widgets (Jump To / Customizations)
• awesome-linux-ricing - ags - Very customizable and extensible shell. (Bar / Nerd Fonts)

README

        
# Aylur's Gtk Shell

> [!IMPORTANT]

> A major update is currently in progress. Before opening a new issue or submitting a pull request, checkout [#504](https://github.com/Aylur/ags/pull/504).

This is a library built for [GJS](https://gitlab.gnome.org/GNOME/gjs) to allow defining GTK widgets in a declarative way. It also provides services and other utilities to interact with the system so that these widgets can have functionality.

GJS is a JavaScript runtime built on Firefox's SpiderMonkey JavaScript engine and the GNOME platform libraries, the same runtime [GNOME Shell](https://gitlab.gnome.org/GNOME/gnome-shell) runs on. 

It was heavily inspired by [EWW](https://github.com/elkowar/eww).

Currently, only Wayland is supported, but it also works on X11, [see #19](https://github.com/Aylur/ags/issues/19).

## Get started

To get started read the [wiki](https://aylur.github.io/ags-docs).