[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-84099":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":29,"readmeContent":30,"aiSummary":10,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":31,"discoverSource":32},84099,"caffyne-shell","caffyne-org\u002Fcaffyne-shell","caffyne-org","A lightweight desktop shell for Wayland on Linux. Powered by Fabric.","https:\u002F\u002Fcaffyne.org",null,"Python",94,1,54,2,0,8,22,38,67.1,false,"main",[24,25,26,27,28],"css","gtk","linux","python","wayland","2026-06-12 04:01:42","![Banner](assets\u002Fbanner.jpg)\n\n---\n\ncaffyne shell is a modern, GTK-based desktop shell built on top of Fabric, Python, and GTK. It features a highly customizable drag-and-drop panel, fluid animations, and deeply integrated system applets designed specifically for modern Wayland compositors.\n\n---\n\n## ✨ Features\n\n* **Modern UI Architecture:** Built with native GTK widgets running smoothly on Wayland.\n* **Dynamic Personalization:** Powered by *Matugen* to deliver seamless *Material You* color palettes derived dynamically from your wallpapers.\n* **Interactive Control Hub:** 15 pre-built applets covering everything from process management to a quick settings panel.\n* **Modular Bar Design:** A highly flexible, drag-and-drop bar structure optimized for flexibility.\n\n---\n\n## 🖥️ Supported Window Managers\n\nWhile caffyne shell does not manage window configurations itself, it connects natively to the following Wayland compositors:\n\n| Window Manager | Status    |\n| -------------- | --------- |\n| **Niri**       | 🟢 Stable |\n| **Hyprland**   | 🧪 Beta   |\n| **MangoWM**    | 🧪 Beta   |\n\n---\n\n## 🚀 Installation\n\n### Quick Install (Arch Linux)\nFor a rapid deployment on Arch Linux, you can stream the setup script directly:\n\n```bash\ncurl -fsSL [https:\u002F\u002Fraw.githubusercontent.com\u002Fcaffyne-org\u002Fcaffyne-shell\u002Fmain\u002Finstall.sh](https:\u002F\u002Fraw.githubusercontent.com\u002Fcaffyne-org\u002Fcaffyne-shell\u002Fmain\u002Finstall.sh) | bash\n```\n\n### Manual Installation\nSee our [Installation Documentation](https:\u002F\u002Fcaffyne.org\u002Fgetting-started\u002Finstallation) for a detailed step-by-step guide.\n\n---\n\n## ⚙️ Configuration & Autostart\n\nTo launch caffyne shell automatically when logging into your compositor session, add the helper script to your compositor configuration:\n\n### Niri (`config.kdl`)\n```ini\nspawn-at-startup \"~\u002F.config\u002Fcaffyne-shell\u002Fstart.sh\"\n```\n\n#### Standard Config (`hyprland.conf`)\n```ini\nexec-once = ~\u002F.config\u002Fcaffyne-shell\u002Fstart.sh\n```\n\n#### Modern Lua Config (`hyprland.lua`)\n```lua\n-- Add this to your exec or startup table\nhyprland.exec_once({ \"~\u002F.config\u002Fcaffyne-shell\u002Fstart.sh\" })\n```\n\n---\n\n## ⌨️ Controlling Applets (IPC Syntax)\n\ncaffyne shell delegates keyboard shortcut assignments to your host window manager. You can toggle applets smoothly via an Inter-Process Communication (IPC) layer using `fabric-cli`:\n\n```ini\n# Example: Niri keybindings to toggle widgets\nMod+Space { spawn \"fabric-cli\" \"exec\" \"caffyne-shell\" \"bar_manager.toggle('Launcher')\"; }\nMod+N     { spawn \"fabric-cli\" \"exec\" \"caffyne-shell\" \"bar_manager.toggle('Notifications')\"; }\n```\n\n### Available Applets\nYou can pass any of these identifier handles into `bar_manager.toggle('\u003CApplet>')`:\n* `Launcher`, `Settings`, `Notifications`, `Clock`, `Calendar`, `Weather`, `Media`, `Volume`, `Wifi`, `Bluetooth`, `Energy`, `Session`, `Calculator`, `Keyboard`, `Processes`.\n\n---\n\n## ❤️ Contributing & Credits\n\nContributions are always welcome! Please check the issues tab, follow our descriptive branching workflow, and submit a pull request. \n\nSpecial thanks to `@its-darsh` (Fabric framework), `@Axenide` (backend clients), `@linkfrg` (Ignis runtime inspiration), and `@amansxcalibur` (UI code snippets) for making this project possible.\n","2026-06-11 04:12:18","CREATED_QUERY"]