{"id":45836217,"url":"https://github.com/retrozinndev/colorshell","last_synced_at":"2026-02-26T23:01:42.890Z","repository":{"id":247652650,"uuid":"822293744","full_name":"retrozinndev/colorshell","owner":"retrozinndev","description":"Super cool desktop shell for Hyprland!","archived":false,"fork":false,"pushed_at":"2026-02-21T17:49:58.000Z","size":447698,"stargazers_count":183,"open_issues_count":10,"forks_count":10,"subscribers_count":2,"default_branch":"ryo","last_synced_at":"2026-02-21T23:33:43.456Z","etag":null,"topics":["ags-v3","astal","aylurs-gtk-shell","desktop-shell","gtk4","gtk4-layer-shell","hyprland","hyprland-shell","hyprlock-theme","rice"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/retrozinndev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"retrozinndev"}},"created_at":"2024-06-30T20:44:46.000Z","updated_at":"2026-02-21T21:05:26.000Z","dependencies_parsed_at":"2024-07-09T23:42:42.656Z","dependency_job_id":"e2ea4819-4627-47a3-8d72-9202f41e8b7a","html_url":"https://github.com/retrozinndev/colorshell","commit_stats":null,"previous_names":["retrozinndev/hyprland-dots"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/retrozinndev/colorshell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/retrozinndev%2Fcolorshell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/retrozinndev%2Fcolorshell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/retrozinndev%2Fcolorshell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/retrozinndev%2Fcolorshell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/retrozinndev","download_url":"https://codeload.github.com/retrozinndev/colorshell/tar.gz/refs/heads/ryo","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/retrozinndev%2Fcolorshell/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29876340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T22:37:10.609Z","status":"ssl_error","status_checked_at":"2026-02-26T22:37:09.019Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ags-v3","astal","aylurs-gtk-shell","desktop-shell","gtk4","gtk4-layer-shell","hyprland","hyprland-shell","hyprlock-theme","rice"],"created_at":"2026-02-26T23:01:41.978Z","updated_at":"2026-02-26T23:01:42.873Z","avatar_url":"https://github.com/retrozinndev.png","language":"TypeScript","funding_links":["https://ko-fi.com/retrozinndev"],"categories":[],"sub_categories":[],"readme":"# colorshell\n\n\u003e [!note]\n\u003e My personal dotfiles are now on [retrozinndev/Hyprland-Dots](https://github.com/retrozinndev/Hyprland-Dots)\n\nThis is the repository for the colorshell desktop shell, made for Hyprland with [TypeScript], [GTK4], [AGS], [Gnim], and some of the [Astal] libraries.\n\nIt really took me a lot of time to make this, so please star the repo if you like it! :star:\n\n## 🌄 Screenshots\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./repo/shots/desktop.png\" alt=\"desktop\" width=\"49%\" /\u003e\n  \u003cimg src=\"./repo/shots/runner.png\" alt=\"Runner\" width=\"49%\" /\u003e\n  \u003cimg src=\"./repo/shots/center-window-control-center.png\" alt=\"Control Center \u0026 Center Window\" width=\"49%\" /\u003e\n  \u003cimg src=\"./repo/shots/kitty.png\" alt=\"Kitty\" width=\"49%\" /\u003e\n\n  \u003cp align=\"right\"\u003e\n    \u003ci\u003emore screenshots on \u003ca href=\"repo/shots\"\u003e\u003ccode\u003erepo/shots\u003c/code\u003e\u003c/a\u003e\u003c/i\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## 🎨 Colors\nAll the shell colors are dynamically generated from your wallpaper! \n\nThis is possible by using [pywal16], a fork of the archived [pywal](https://github.com/dylanaraps/pywal) project. \nIt's a cli tool to generate color schemes from an image.\n\n## 🖼️ Wallpapers\nThese are not included in the shell anymore, because the repository was getting too big in size. \nSo you'll have to add it in your own.\n\nYou can add more wallpapers either by adding your custom images to `~/wallpapers` or by defining `WALLPAPERS` \nin your `hypr/user/environment`, pointing to the custom location.\n\nAlso, you can select any of the images inside `~/wallpapers` by pressing \n\u003ckbd\u003eSUPER\u003c/kbd\u003e + \u003ckbd\u003eW\u003c/kbd\u003e or by accessing the Control Center and clicking in the image \nicon on top.\n\n## ✨ Features\n\u003cdetails\u003e\n  \n- Pretty Top-Bar\n  - Apps(basically the \"start menu\", opens the full-screen app launcher)\n  - Workspaces indicator\n  - Focused Client(window) information(title, class and icon)\n  - Clock(with date)\n  - Media\n    - Change current player by scrolling on top of the widget or by opening the\nCenter Window and scrolling the player\n    - Only available when there's media playing\n  - Tray(Applications running in the background)\n  - Status (volume information, bluetooth, network and notification status)\n- Control Center\n  - Sliders \n    - Speaker volume\n    - Microphone sensitivity\n    - Brightness amount\n  - Pages(the thing that shows up when you click the arrow on a tile)\n    - Bluetooth devices\n    - Network devices\n    - Night Light controls\n    - Brightness options\n  - Tiles\n    - Screen Recording\n    - Bluetooth\n    - Night Light\n    - Network(wifi needs work, i don't have wifi in my machine)\n    - Don't Disturb(disables notification popups)\n- Center Window(clock, calendar + media management)\n- OSD (On-screen Display)\n  - Brightness(when changed)\n  - Volume(when changed)\n- Notifications with support for application actions + Notification History\n- Localization(see [🌐 Internationalization](#-internationalization) for available languages)\n- Application Runner with support for plugins ([anyrun](https://github.com/anyrun-org/anyrun)-like)\n  - Shell(`!`): Run shell commands with the user shell\n  - Clipboard(`\u003e`): Search through your clipboard history\n  - Wallpapers(`#`): Search and select to change wallpaper\n  - Media(`:`): Control playing media\n  - Search(`?`): Search something on the internet with your default browser\n- Support for your multiple monitors\n- Configurable behavior through a config file(see [Configuring](#-configuring))\n- Dynamic support for [UWSM](https://github.com/Vladimir-csp/uwsm)(apps will use uwsm if current session is using it)\n\u003c/details\u003e\n\n## ⌨️ Binds\nYou can see default bindings and usage information on the [Wiki/Usage] page!\n\n## 🌐 Internationalization\nColorshell supports i18n! The shell automatically matches the shell language with the system's, if available. \u003cbr\u003e\nCurrently, there's support for the following languages: \n- **English** (English, United States), maintained by [@retrozinndev](https://github.com/retrozinndev)\n- **Português** (Portuguese, Brazil), maintained by [@retrozinndev](https://github.com/retrozinndev)\n- **Русский** (Russian), maintained by [@NotMephisto](https://github.com/NotMephisto)\n- **Français** (French, France \u0026 Belgium), maintained by [@Elgemp4](https://github.com/Elgemp4)\n  \nDon't see your language here? You can contribute and make translations too! \u003cbr\u003e\nYou can do so by forking this repository, translating the shell in your fork and then opening a pull request to this repository, simple as that!\n(I'll create a more detailed guide for that soon)\n\n## ⚙️ Installation\nSee the Installation Guide on [Wiki/Installation].\n\n## ⬇️ Updating\nYou can run the following command to update an existing colorshell installation in your system(this won't work on Nix):\n```zsh\nbash -c \"bash \u003c(curl -s https://raw.githubusercontent.com/retrozinndev/colorshell/refs/heads/ryo/update.sh)\"\n```\n### Updating on Nix\nYou need to update the profile that contains the flake:\n```zsh\nnix profile upgrade\n```\n\n## ⚙️ Configuring\nThere is a configuration file! You can see its documentation on [Wiki/Configuration].\n\n## 🛠️ Development\nThis project uses `pnpm` to manage packages and running scripts.\nTo build the shell, run a development build or make a release build, you can use the project's integrated scripts.\u003cbr\u003e\nThe most complicated ones have a help flag, so you can learn from there.\n\n### Dependencies\nThese are development-only dependencies(by package name on AUR):\n- `aylurs-gtk-shell-git`\n  \nPlus, you also need the packages listed in [Wiki/Dependencies]!\n\n### Building\nIn a common build, the shell's gresource(icons and sass) will be targeted to the build output directory by default.\nIf you want to ship it, you likely want to use the `pnpm build:release` command.\n```zsh\npnpm build -d # remove the -d flag if you don't want a development build\n```\nIf you want to ship the build(or install it on your local machine), you'll likely prefer a release build:\n(the `build:release` command targets the gresource to `$XDG_DATA_HOME/colorshell/resources.gresource` by default)\n```zsh\npnpm build:release\n```\nDon't forget to install the gresource to the actual target directory! Or else it'll not find the resource file and will fail\nto load custom assets.\u003cbr\u003e\nAlso, the environment variables are only actually used at runtime! It's passed as a literal string in the bash\nvariable format, then when the shell runs, it understands that it's an environment variable and replaces it with it's value.\n\n### Testing/Running the project\n```zsh\npnpm dev\n```\nor if you actually only want to run the current build instead of building again:\n```\npnpm start\n```\n\n## ❗ Issues\nHaving issues? Please create a [new Issue] here, I'll be happy to help you out!\n\n## 📜 License\nThis repo is licensed under the [BSD 3-clause] license, project is made and maintained by [retrozinndev](https://github.com/retrozinndev).\n\n## 🌠 Stargazers\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://www.star-history.com/#retrozinndev/colorshell\u0026Date\"\u003e\n        \u003cpicture\u003e\n            \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=retrozinndev/colorshell\u0026type=Date\u0026theme=dark\" /\u003e\n            \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=retrozinndev/colorshell\u0026type=Date\" /\u003e\n            \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=retrozinndev/colorshell\u0026type=Date\" /\u003e\n        \u003c/picture\u003e\n    \u003c/a\u003e\n    \u003cbr\u003e\n    \u003cp align=\"center\"\u003eThanks to everyone who starred my project! 💖\u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- References of other projects --\u003e\n[pywal16]: https://github.com/eylles/pywal16\n[zen browser]: https://zen-browser.app\n[neovim]: https://neovim.io\n[nushell]: https://nushell.sh\n[kitty]: https://sw.kovidgoyal.net/kitty\n[ags]: https://aylur.github.io/ags\n[gnim]: https://aylur.github.io/gnim\n[astal]: https://aylur.github.io/astal\n[typescript]: https://typescriptlang.org\n[gtk4]: https://www.gtk.org\n[gtk]: https://www.gtk.org\n\n\u003c!--  Web refs --\u003e\n[bsd 3-clause]: https://en.wikipedia.org/wiki/BSD_licenses#4-clause_license_(original_%22BSD_License%22)\n\n\u003c!-- Tabs --\u003e\n[wiki]: https://github.com/retrozinndev/colorshell/wiki\n[issues]: https://github.com/retrozinndev/colorshell/issues\n\n\u003c!-- Wiki Pages --\u003e\n[wiki/dependencies]: https://github.com/retrozinndev/colorshell/wiki/Dependencies\n[wiki/usage]: https://github.com/retrozinndev/colorshell/wiki/Usage\n[wiki/installation]: https://github.com/retrozinndev/colorshell/wiki/Installation\n[wiki/configuration]: https://github.com/retrozinndev/colorshell/wiki/Configuration\n\u003c!-- Actions --\u003e\n[new issue]: https://github.com/retrozinndev/colorshell/issues/new\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fretrozinndev%2Fcolorshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fretrozinndev%2Fcolorshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fretrozinndev%2Fcolorshell/lists"}