{"id":13533559,"url":"https://github.com/Zerodya/hyprfreeze","last_synced_at":"2025-04-01T21:32:33.574Z","repository":{"id":192268278,"uuid":"686389338","full_name":"Zerodya/hyprfreeze","owner":"Zerodya","description":"Utility to suspend a game process (and other programs) in Hyprland and Sway","archived":false,"fork":false,"pushed_at":"2025-01-12T12:04:48.000Z","size":3586,"stargazers_count":84,"open_issues_count":3,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-12T12:34:03.552Z","etag":null,"topics":["games","hyprland","multitask","pause","suspend","sway","wayland"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/Zerodya.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}},"created_at":"2023-09-02T16:18:38.000Z","updated_at":"2025-01-12T11:56:12.000Z","dependencies_parsed_at":"2024-04-27T17:30:28.544Z","dependency_job_id":"50757e5d-1904-49d5-b466-0d17fb28cc88","html_url":"https://github.com/Zerodya/hyprfreeze","commit_stats":null,"previous_names":["zerodya/hyprfreeze"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zerodya%2Fhyprfreeze","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zerodya%2Fhyprfreeze/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zerodya%2Fhyprfreeze/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zerodya%2Fhyprfreeze/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zerodya","download_url":"https://codeload.github.com/Zerodya/hyprfreeze/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246713477,"owners_count":20821895,"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":["games","hyprland","multitask","pause","suspend","sway","wayland"],"created_at":"2024-08-01T07:01:20.985Z","updated_at":"2025-04-01T21:32:33.568Z","avatar_url":"https://github.com/Zerodya.png","language":"Shell","funding_links":[],"categories":["Tools"],"sub_categories":["Workspace"],"readme":"# hyprfreeze\n[![basher install](https://www.basher.it/assets/logo/basher_install.svg)](https://www.basher.it/package/)\n\nHyprfreeze is a utility to suspend a game process (and other programs) in Hyprland and Sway.\n\nhttps://github.com/Zerodya/hyprfreeze/assets/73220426/541318e2-441a-485a-91c5-f58d4f65926a\n\n**Useful to:**\n- Pause single-player games that can't normally be paused (Elden Ring, Baldur's Gate 3, ...)\n- Pause cutscenes to read the subtitles or if you suddenly need to leave your desk\n- Save system resources (excluding RAM) if you need them for another computer task, or if the game's pause menu uses too many\n\n\u003e **Note:** This repo is in **maintenance-only** mode as it is feature-complete for my scope.\n\u003e - For Hyprland: I use this tool in Hyprland everyday and will update it to fix potential bugs or when `hyprctl` changes its syntax. \n\u003e - For Sway: it's not my first priority as I don't daily drive it, so if it stops working there please open a new issue as I will not be aware of it.\n\n## Installation\n### Arch Linux\nHyprfreeze is available in the [AUR](https://aur.archlinux.org/packages/hyprfreeze-git). (Maintained by [Aethar](https://github.com/Aethar01))\n\n### Dependencies\n- a compatible window manager (`hyprland` or `sway`) to get the PID of the active window\n- `jq` to parse json\n- `psmisc` contains 'pstree' which is required to list child processes\n  ### Optional\n- [`hyprprop`](https://github.com/vilari-mickopf/hyprprop) or [`swayprop`](https://git.alternerd.tv/alterNERDtive/swayprop) to get the pid of a window by selecting it with your mouse\n  ### Highly Recommended\n- Running games in [`gamescope`](https://github.com/ValveSoftware/gamescope) fixes mouse input not working in other XWayland windows after pausing a Wine game (see [#1](https://github.com/Zerodya/hyprfreeze/issues/1)). It's also the superior way to game in Wayland anyway.\n\n### Basher\nHyprfreeze is compatible with shell script package manager [Basher](https://basher.it).\n```bash\nbasher install Zerodya/hyprfreeze\n```\n\n### Manual\nClone this repo and symlink the `hyprfreeze` script to a directory in your `PATH`:\n```bash\ngit clone https://github.com/Zerodya/hyprfreeze.git Hyprfreeze\nln -s $(pwd)/Hyprfreeze/hyprfreeze $HOME/.local/bin\n```\n\n## Usage\nAdd a bind in your Hyprland or Sway config to pause the current active window:\n```bash\n# ~/.config/hypr/hyprland.conf\n...\n# Toggle freeze on active window\nbind = , PAUSE, exec, hyprfreeze -a\n```\n### Available flags\n```\n-h, --help            show help message\n\n-a, --active          toggle suspend by active window\n-p, --pid             toggle suspend by process id\n-n, --name            toggle suspend by process name/command\n-r, --prop            toggle suspend by clicking on window (hyprprop/swayprop must be installed)\n\n-s, --silent          don't send notification\n-t, --notif-timeout   notification timeout in milliseconds (default 5000)\n--info                show information about the process\n--dry-run             doesn't actually suspend/resume a process, useful with --info\n--debug               enable debug mode\n```\n### Examples:\n```bash\n# Pause game by process name\nhyprfreeze -n eldenring.exe\n```\n```bash\n# Get info about a process by clicking on its window, without suspending it\nhyprfreeze -r --info --dry-run\n```\n## Disclaimer\nThere is always the risk, although slim, that an application may crash.\n\nThis is intrinsically related to modifying running processes and is not something that Hyprfreeze can prevent.\n\nPlease make sure to **save your data** before using hyprfreeze.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZerodya%2Fhyprfreeze","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZerodya%2Fhyprfreeze","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZerodya%2Fhyprfreeze/lists"}