Introduction
What is @myxogastria0808/tadaima?
Section titled “What is @myxogastria0808/tadaima?”@myxogastria0808/tadaima is a greetd greeter library for AGS / GJS.
It handles the hard parts of building a login screen:
- Authentication — communicates with greetd via the greetd-ipc(7) protocol (JSON over Unix socket)
- Session discovery — reads
.desktopfiles from standard XDG directories - State caching — remembers the last authenticated user and session
You bring the UI — use any GTK4 widget to design your login screen.
Why @myxogastria0808/tadaima?
Section titled “Why @myxogastria0808/tadaima?”- No Astal Greet dependency — @myxogastria0808/tadaima implements the greetd IPC protocol directly, removing the need for
gi://AstalGreet - TypeScript first — full type safety with JSDoc documentation
- Framework agnostic — works with AGS/Gnim JSX, but the library itself has no UI opinions
- Distro agnostic — works on NixOS, Arch-based distributions, and any system with greetd and Nix.
Architecture
Section titled “Architecture”@myxogastria0808/tadaima is built on top of greetd, a minimal and flexible login manager daemon for Linux. greetd handles the low-level authentication (via PAM) and session lifecycle, while exposing a simple IPC protocol over a Unix socket. @myxogastria0808/tadaima implements this greetd-ipc(7) protocol — sending JSON requests and receiving responses — so your greeter can authenticate users and start sessions without dealing with the socket or protocol details directly.
Getting Started
Section titled “Getting Started”Choose your platform to get started:
Arch Linux For Arch-based distributions (Arch, Manjaro, EndeavourOS, etc.)
NixOS For NixOS with flake-based module integration
Nix (non-NixOS) For using Nix as a package manager on other distributions