{"id":50462024,"url":"https://github.com/mszost/quickshell-config","last_synced_at":"2026-06-01T05:01:35.278Z","repository":{"id":358720440,"uuid":"1133819752","full_name":"mszost/quickshell-config","owner":"mszost","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-18T19:08:57.000Z","size":20862,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-18T21:15:03.225Z","etag":null,"topics":["dotfiles","gruvbox","hyprland","nord","quickshell","rice","ricing","unixporn"],"latest_commit_sha":null,"homepage":"","language":"QML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mszost.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-13T21:29:02.000Z","updated_at":"2026-05-18T19:09:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mszost/quickshell-config","commit_stats":null,"previous_names":["mszost/quickshell-config"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mszost/quickshell-config","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mszost%2Fquickshell-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mszost%2Fquickshell-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mszost%2Fquickshell-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mszost%2Fquickshell-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mszost","download_url":"https://codeload.github.com/mszost/quickshell-config/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mszost%2Fquickshell-config/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33760658,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["dotfiles","gruvbox","hyprland","nord","quickshell","rice","ricing","unixporn"],"created_at":"2026-06-01T05:01:34.585Z","updated_at":"2026-06-01T05:01:35.270Z","avatar_url":"https://github.com/mszost.png","language":"QML","funding_links":[],"categories":[],"sub_categories":[],"readme":"This repo contains my personal [Quickshell](https://quickshell.org/) configuration for Hyprland on Arch Linux. \n\n## Goals\n- Most of the functionality expected from a complete desktop environment\n- Information-dense while remaining unobtrusive and visually appealing\n- Customizability through a config file and extensible design\n- Reasonably low system resource usage\n\n\n## Showcase\n\n![leftbar.png](assets/img/leftbar.png)\n\n\n![audiopanel.png](assets/img/audiopanel.png)\n\n\n![dock.png](assets/img/dock.png)\n\n\n## Features\n- [x] macOS/GNOME-like application dock\n- [x] Status bar with widgets for:\n    - [x] Clock\n    - [x] Volume\n    - [x] Battery\n    - [x] Network\n    - [x] Hyprland workspaces\n    - [x] Brightness and blue light filter\n    - [x] System package update reminders\n    - [x] System tray (WIP, app icons render but are not yet interactive)\n    - [ ] Bluetooth\n    - [ ] Clipboard \n    - [ ] Caps-lock status\n    - [ ] System resource monitoring\n    - [ ] Local weather \n- [x] Menu system featuring: \n    - [x] Volume and audio device manager\n    - [x] Display brightness and blue light filter controls\n    - [ ] Network + Blueooth connection manager\n    - [ ] Power/TDP profile manager\n    - [ ] Calendar\n    - [ ] Keyboard backlight\n    - [ ] Media controls\n- [x] Theming, including support for Matugen color generation from an image\n- [x] OSD popups for volume, brightness, etc.\n- [x] Sound effects (WIP)\n- [x] Animations\n- [ ] Session manager / logout overlay\n- [ ] Centralized dashboard menu\n- [ ] rofi-like app launcher\n- [ ] Notification system\n- [ ] Wallpaper manager\n- [ ] IPC commands\ngithub \n\n## Installation (Arch-based distros)\n\nDependencies:\n```sh\nnoctalia-qs  # or quickshell\nhyprland     # or hyprland-git\nhyprsunset\npipewire\nnetworkmanager\nupower\nmatugen      # (optional, but the file Theme/Matugen.qml must be created)\n```\n\nThen, place the following somewhere in your Hyprland config:\n```\nlayerrule = blur on, match:class quickshell\nlayerrule = blur_popups on, match:class quickshell \nlayerrule = ignore_alpha 0.1, match:class quickshell\nlayerrule = no_anim on, match:class quickshell\n```\n\nI also recommend installing `menulibre` or an equivalent software for management of .desktop files which are used by the dock.\n\nTo run the shell, clone this repository then execute `quickshell -c /path/to/shell/` (replace with actual location)\n\n\n## Customization\n\u003e I've made an effort for the project to be modular to some extent, but it is still primarily for my personal use and customization might not be the most friendly experience. `Config.qml` contains several options and is a good place to start.\n\n\n### Project Structure\n\n```sh\n.\n├── assets/               \n├── components/           # Templates and reusable items\n├── modules/              # Bundles related to a certain feature\n│   └── module/           \n│       ├── *Service.qml  # Backend logic for the module\n│       ├── *Panel.qml    # Implementation of a Panel component\n│       └── *Widget.qml   # Implementation of a BarWidget component \n├── style/                # Declaration of color themes, fonts, sounds\n└── views/                # Top-level rendering and positioning \n```\n\n## Acknowledgements\n\n#### Design inspiration\n- [Noctalia shell](https://github.com/noctalia-dev/noctalia-shell) \n- [end_4's Illogical Impulse](https://github.com/end-4/dots-hyprland)\n- [rumda](https://github.com/Nytril-ark/rumda)\n- macOS\n- KDE Plasma 6\n\n#### Code\n- [end_4's Illogical Impulse](https://github.com/end-4/dots-hyprland) was a valuable reference for the network service scripts.\n\n#### Other\n- [Tabler](https://tabler.io/icons) icons\n- [xZepyx's nucleus-shell](https://github.com/nucleus-hq/nucleus-shell) for being a good example which helped me with learning QML early on\n- outfoxxed and other contributors for creating Quickshell and its documentation :)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmszost%2Fquickshell-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmszost%2Fquickshell-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmszost%2Fquickshell-config/lists"}