{"id":13455892,"url":"https://github.com/CryoByte33/steam-deck-utilities","last_synced_at":"2025-03-24T09:30:53.869Z","repository":{"id":62764812,"uuid":"559577091","full_name":"CryoByte33/steam-deck-utilities","owner":"CryoByte33","description":"A utility to improve performance and help manage storage on Steam Deck.","archived":false,"fork":false,"pushed_at":"2024-02-04T12:12:58.000Z","size":352,"stargazers_count":3355,"open_issues_count":65,"forks_count":81,"subscribers_count":46,"default_branch":"main","last_synced_at":"2025-03-23T13:20:00.282Z","etag":null,"topics":["steam-deck"],"latest_commit_sha":null,"homepage":"","language":"Go","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/CryoByte33.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},"funding":{"patreon":"cryobyte33","ko_fi":"cryobyte33"}},"created_at":"2022-10-30T14:50:04.000Z","updated_at":"2025-03-23T11:17:41.000Z","dependencies_parsed_at":"2023-11-25T11:20:34.972Z","dependency_job_id":"a5ea4a97-e6c6-4b8a-a026-0c187405a05d","html_url":"https://github.com/CryoByte33/steam-deck-utilities","commit_stats":null,"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryoByte33%2Fsteam-deck-utilities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryoByte33%2Fsteam-deck-utilities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryoByte33%2Fsteam-deck-utilities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryoByte33%2Fsteam-deck-utilities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CryoByte33","download_url":"https://codeload.github.com/CryoByte33/steam-deck-utilities/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245243159,"owners_count":20583574,"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":["steam-deck"],"created_at":"2024-07-31T08:01:13.006Z","updated_at":"2025-03-24T09:30:53.829Z","avatar_url":"https://github.com/CryoByte33.png","language":"Go","funding_links":["https://patreon.com/cryobyte33","https://ko-fi.com/cryobyte33"],"categories":["Go","Applications","Performance Tweaks","Utility","Software Setup"],"sub_categories":["Games"],"readme":"# CryoUtilities\n\nScripts and utilities to improve performance and manage storage on the Steam Deck. (May work with other Linux distros.)\n\n[![Watch me on YouTube:](https://img.shields.io/youtube/channel/subscribers/UCJ2wc4hCWI8bEki48Zv45fQ?color=%23FF0000\u0026label=Subscribe%20on%20YouTube\u0026style=flat-square)](https://www.youtube.com/@cryobyte33) \n[![Support me on Patreon](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dcryobyte33%26type%3Dpatrons\u0026style=flat)](https://patreon.com/cryobyte33)\n\n## Update\n\n### Notes on the Steam Deck OLED\nThe latest update resolves the scaling issues on the new OLED Deck, and I figured I should provide an update here:\n1. **This (CU2) is still fully compatible with the new OLED models.**\n2. Performance improvements should be similar (or possibly slightly better) than on the LCD model (thorough testing pending)\n\n### General Linux Compatibility\nAs of the latest update, this _should_ be compatible with most Linux systems, with the following limitations:\n1. This will not operate on swap partitions, only files.\n2. The Game Data and VRAM tabs will likely not work\n3. Pop_OS! has a custom swappiness that will override any value set here after reboot.\n\nPlease keep in mind that support for non-Steam Deck devices is on a \"best effort\" basis, and will have a low priority.\nUnfortunately, the amount of effort and support that would be needed to guarantee functionality for all distros would\nrequire me to be working on this full-time, which is not the case.\n\nIf you want to use the tweaks here without relying on this tool, please see the \"How Does it Work\" section below.\n\n### VRAM Tab\nThere's a new VRAM tab which will tell you the current \"UMA Frame Buffer Size\" setting, and how to configure it if\nyou haven't already!\n\n### Swap Improvements\nThe swapfile path is now completely dynamic and the resize functionality can recover in the event of an earlier failure!\nYou no longer need to manually intervene if a previous swap resize failed, just run the resize again and it'll work its\nmagic.\n\n### One-Click Game Data Cleanup\nThere's now a simple \"Delete all uninstalled\" button in the \"Clean Game Data\" window. Just click it and all the data\nfrom uninstalled games will be removed! \n\n**Please keep in mind that non-cloud-saved save games should still be backed up manually before using this.**\n\n## Explanation and Tutorial\n\nIf you're interested, please see the [announcement video here](https://youtu.be/C9EjXYZUqUs), where I go over all the\nnew features and how they work.\n\n## Functionality\n\n* One-click set-to-recommended settings\n* One-click revert-to-stock settings\n* Swap Tuner\n    * Swap File Resizer + Recovery\n    * Swappiness Changer\n* Memory Parameter Tuning\n    * HugePages Toggle\n    * Compaction Proactiveness Changer\n    * HugePage Defragmentation Toggle\n    * Page Lock Unfairness Changer\n    * Shared Memory (shmem) Toggle\n* Storage Manager\n    * Sync shadercache and compatdata to the same location the game is installed\n    * Delete shadercache and compatdata for whichever games you select\n    * Delete the shadercache and compatdata for all uninstalled games with a single click\n* Full CLI mode\n\nLook below for common questions and answers, or go check out my [YouTube Channel](https://www.youtube.com/@cryobyte33)\nfor examples on how to use this and what performance you can expect.\n\n## Install\n\n### Simple\n\n[Download this link](https://raw.githubusercontent.com/CryoByte33/steam-deck-utilities/main/InstallCryoUtilities.desktop)\nto your desktop (right click and save file) on your Steam Deck, remove the `.download` from the end of the file name, \nthen double-click it.\n\nThis will install the program, create desktop icons, and create menu entries.\n\n### Manual\n\nSee [manual-install.md](https://github.com/CryoByte33/steam-deck-utilities/blob/main/docs/manual-install.md).\n\n### Offline/Firewalled\n\nIn case you're in a firewalled country like China, please see [this post on my website](https://cryobyte.io/posts/2023/03/cryoutilities-offline-installation/)\nfor install directions and a non-GitHub download link.\n\n## Usage\n\n**NOTE:** This **REQUIRES** a password set on the Steam Deck. That can be done with the `passwd` command.\n\n### GUI\n\nAfter installation, just run the \"CryoUtilities\" icon on the desktop or the application menu under \"Utilities\".\n\n### CLI\n\nThe latest version has a full CLI handler, which can be used to perform all tweaks, but doesn't perform game data\noperations.\n\n```\nsudo ~/.cryo_utilities/cryo_utilities \u003ccommand\u003e [parameter]\n```\n\nIf you want to see the available commands and accepted values, you can use:\n\n```\nsudo ~/.cryo_utilities/cryo_utilities help\n```\n\n**Note:** You _need_ to use sudo for the tweaks to work, otherwise it can't write to the necessary locations on disk.\n\n## Upgrade\n\nDouble-click the \"Update CryoUtilities\" icon on the desktop, you will get a dialog box when the update is complete.\n\n## Uninstall\n\nDouble-click the \"Uninstall CryoUtilities\" icon on the desktop, you will be asked if you're sure, then asked if you want\nto revert the tweaks that have been made.\n\n## Revert To Default Settings\n\nTo revert to the Steam Deck defaults, do one of the following:\n\n* Boot CryoUtilities and click \"Stock\" on the homepage.\n* Uninstall CryoUtilities, you'll be asked if you want to revert to stock settings. Choose yes.\n\nAfter choosing these options, the Deck will be identical to an unmodified version.\n\n## Known Issues\n\n* If the drive becomes full during the swap file resize, you can trigger a known SteamOS bug that causes boot loops.\n    * CryoUtilities is programmed in such a way to not allow this, but in the very worst cases it's still possible if\n      something is operating/downloading in the background, at the same time CryoUtilities resizes the swap file.\n    * In the event that it happens, you need to either get into a live environment and delete some files, or reinstall\n      SteamOS with the non-destructive method.\n* While using CLI mode, it is possible that the swap file resize takes long enough that the sudo credentials will time\n  out.\n    * This does not occur in GUI mode, due to how I was able to implement authentication, and will be patched out of\n      CLI-only mode soon.\n\n## FAQ\n\nSee [the FAQ page](https://github.com/CryoByte33/steam-deck-utilities/blob/main/docs/faq.md).\n\n## What does it do?\n\nSee [the tweak explanation page](https://github.com/CryoByte33/steam-deck-utilities/blob/main/docs/tweak-explanation.md).\n\n## Troubleshooting\n\n### CryoUtilities doesn't appear after double-clicking the icon on the desktop\n\n* Make sure that you're using SteamOS 3.4 or later\n* Verify that `/home/deck/.cryo_utilities/cryo_utilities` and `/home/deck/.cryo_utilities/launcher.sh` exist\n    * `/home/deck/.cryo_utilities` is a hidden directory, so ensure that you can view hidden files\n\nIf the above doesn't work, please open an issue here or contact in the [Discord](https://discord.gg/ySe8WGVNPv)!\n\n### I have instability in a game after using CryoUtilities' recommended settings\n\nTry rebooting the Deck and trying again, I haven't heard of instability post-reboot, but if you find some please let\nme know!\n\n### Right-clicking the link to save it doesn't open a dialog box\n\nReboot the Deck or restart desktop mode, afterwards the link should work.\n\n### The .desktop file just opens with KWrite after I download it.\n\nMake sure the `CryoUtilities.desktop` file is on the desktop when you run it. If that still doesn't work, try one of the\nfollowing:\n\n* Run `chmod +x ~/Downloads/InstallCryoUtilities.desktop` and then try again.\n* Add `CryoUtilities.desktop` as a Non-Steam game and run it from Steam.\n\n### The swap resize times out\n\nGo to Game Mode, navigate to Settings \u003e System, then press \"Run storage device maintenance tasks\" at the very bottom.\nAfter it's completed, you should be able to resize the swap file easily.\n\n### Trying to do anything crashes the program\n\nMake sure that you installed using the installer. If you can't, then run:\n\n```bash\nchown -R deck:deck ~/.cryo_utilities\nchmod -R 777 ~/.cryo_utilities\n```\n\nThese permissions are more open than necessary, though, so only do it as a last resort.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCryoByte33%2Fsteam-deck-utilities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCryoByte33%2Fsteam-deck-utilities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCryoByte33%2Fsteam-deck-utilities/lists"}