{"id":23739557,"url":"https://github.com/CachyOS/CachyOS-Handheld","last_synced_at":"2025-09-04T15:31:08.815Z","repository":{"id":231923615,"uuid":"783048649","full_name":"CachyOS/CachyOS-Handheld","owner":"CachyOS","description":"CachyOS for Handhelds ","archived":false,"fork":false,"pushed_at":"2024-08-23T21:20:08.000Z","size":3006,"stargazers_count":15,"open_issues_count":9,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-29T14:22:24.631Z","etag":null,"topics":["cachyos","gamingonlinux","linux","steamos"],"latest_commit_sha":null,"homepage":"https://cachyos.org","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CachyOS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-04-06T19:50:39.000Z","updated_at":"2024-10-26T19:09:24.000Z","dependencies_parsed_at":"2024-11-08T23:25:04.907Z","dependency_job_id":"92976b73-4fd3-4921-a7cd-a480fad7abbf","html_url":"https://github.com/CachyOS/CachyOS-Handheld","commit_stats":{"total_commits":146,"total_committers":5,"mean_commits":29.2,"dds":0.6643835616438356,"last_synced_commit":"e9e9d1882633317bd608e7164aef9fe219179788"},"previous_names":["cachyos/cachyos-deckify","cachyos/cachyos-handheld"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CachyOS%2FCachyOS-Handheld","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CachyOS%2FCachyOS-Handheld/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CachyOS%2FCachyOS-Handheld/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CachyOS%2FCachyOS-Handheld/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CachyOS","download_url":"https://codeload.github.com/CachyOS/CachyOS-Handheld/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230634393,"owners_count":18256862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cachyos","gamingonlinux","linux","steamos"],"created_at":"2024-12-31T09:37:01.785Z","updated_at":"2025-09-04T15:31:08.798Z","avatar_url":"https://github.com/CachyOS.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Cachyos-Handheld-Edition\n\nHandheld Edition of CachyOS\n\nThis will include our own calamares, adjusted desktop and scripts for proper installation on handhelds.\nWe will provide only the online installation, so an internet connection will be mandatory.\n\nCurrently it is not planned to support more bootloaders, but if there is any interest we can simply add them as in our default ISOs, for now we will default to systemd-boot.\nThere will be support for 5 different filesystems:\n\n- xfs\n- ext4\n- btrfs (default)\n- zfs\n- bcachefs\n\nThere will also be automatic snapshotting implemented, to make it easy for users to rollback if they run into issues.\nBcachefs could be generally a good idea for handhelds, but it is not fully ready yet and we don't suggest it for now.\n\n## Features\n- scx_lavd used as default scheduler - LAVD is a latency sensitive scheduler, which is intended to be used for handhelds and gaming\n- Steam Deck like Steam Expierence\n- Gamescope Session properly implemented\n- Kernel Patched to have support for Steam Deck OLED\n- Steam Deck OLED Firmware included as default\n- HDR correctly implemented via kernel patches\n- All dependecies and packages bundled for a proper gaming expierence (cachyos-gaming-meta)\n- Support for Winesync/Fastsync/NTSync\n- BBRv3 used as default\n- OpenRGB Patches included\n- Screensharing for Discord (via xwaylandvideobridge)\n- CachyOS Kernel\n- CachyOS Repository (all packages compiled with avx2/avx512 including auto detection for cpu support)\n- Orientation patches for several handheld devices\n- Support for Rog Ally patched in the kernel\n- Fixes and improvements for VRR on AMD\n\n## Planned\n- Improve the experience further to provide a Steam Deck similar experience to SteamOS\n- Provide the Steam Deck Themes\n- Enhance Hardware Support\n\n## Device specific / Officially supported devices\nDevice specific customizations are mainly provided by the chwd profiles [Profiles](https://github.com/CachyOS/chwd/blob/master/profiles/pci/handhelds/profiles.toml) and the kernel.\n### Steam Deck\nValve's powerbuttond is used to handle power button events\\\nSteam is used for controller support.\n### ROG Ally\nsteam-powerbuttond-git is used to handle power button events.\\\nInputPlumber is used for controller support.\\\nRogue enemy is an alternative that provides power profile switching and controller support.\n### Lenovo Legion\nHandheld Daemon (HHD) is used by default to provide power button handling and controller support.\n\n## Non Officially supported hardware.\nOn not tested/supported hardware, you may face issues such as wrong screen orientation, missing sound, etc.\nHHD is not enabled automatically on unknown hardware, as such it must be enabled for specific controllers to work.\n\n\n## Desktop Support\n\nit is generally planned to enhance the support further also for desktops.\nThis generally already works, but swichting the gamesession on Desktops could show problems.\n\n\n## Additonal Information\n\n### How can I disable scx_lavd and use the BORE/EEVDF Scheduler?\n\nThis can be simply done with following:\n```\nsudo systemctl disable scx.service\nsudo systemctl mask scx.service\n```\n### How can I change the default desktop scaling?\nFor unofficially support devices the scaling is provided by KDE.\\\nFor officially supported devices (deck, ally, legion go, etc) the scaling is provided by a custom deckscale script.\\\nThe values used by this script can be configured using the configuration file located at ~/.config/deckscale\\\nIf this file does not exist for you, create it and add the contents from [this file.](https://github.com/CachyOS/CachyOS-Handheld/blob/main/etc/skel/.config/deckscale)\n\n## Credit to:\n- ChimeraOS\n- Ripplingsnake\n- Manjaro (Phillip Müller for the base deckify package)\n- Bazzite\n\n## Maintainers\n- Pogogo007 (Nekoh)\n- ptr1337\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCachyOS%2FCachyOS-Handheld","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCachyOS%2FCachyOS-Handheld","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCachyOS%2FCachyOS-Handheld/lists"}