{"id":30909336,"url":"https://github.com/eth-p/gamedownsights","last_synced_at":"2026-05-18T19:33:59.318Z","repository":{"id":307055991,"uuid":"1024656634","full_name":"eth-p/gamedownsights","owner":"eth-p","description":"A gamescope wrapper that automatically sets the gamescope arguments and environment variables based on for your display settings.","archived":false,"fork":false,"pushed_at":"2025-07-29T06:00:43.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-29T08:30:01.874Z","etag":null,"topics":["gamescope","hdr","linux","linux-gaming","steam"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eth-p.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}},"created_at":"2025-07-23T03:59:27.000Z","updated_at":"2025-07-29T06:00:47.000Z","dependencies_parsed_at":"2025-07-29T08:40:29.589Z","dependency_job_id":null,"html_url":"https://github.com/eth-p/gamedownsights","commit_stats":null,"previous_names":["eth-p/gamedownsights"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/eth-p/gamedownsights","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fgamedownsights","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fgamedownsights/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fgamedownsights/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fgamedownsights/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eth-p","download_url":"https://codeload.github.com/eth-p/gamedownsights/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fgamedownsights/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274321499,"owners_count":25263684,"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","status":"online","status_checked_at":"2025-09-09T02:00:10.223Z","response_time":80,"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":["gamescope","hdr","linux","linux-gaming","steam"],"created_at":"2025-09-09T15:51:34.843Z","updated_at":"2026-05-18T19:33:54.293Z","avatar_url":"https://github.com/eth-p.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gamedownsights\n\nA Steam launch options wrapper that automatically launches and configures\nwrappers such as [gamescope](https://github.com/ValveSoftware/gamescope).\n\n## Features\n\n### Gamescope\n\nhttps://github.com/ValveSoftware/gamescope\n\n - Enables HDR based on display settings.\n - Enables VRR based on display settings.\n - Enables inverse tone mapping for non-HDR games.\n - Sets refresh rate.\n - Sets screen resolution.\n\n\u003e [!tip]\n\u003e Gamescope is enabled by default.  \n\u003e You can disable it by adding `ENABLE_GAMEMODE=false` to your overrides.\n\n### GameMode\n\nhttps://github.com/FeralInteractive/gamemode\n\n\u003e [!tip]\n\u003e GameMode is enabled by default if it's installed.  \n\u003e You can disable it by adding `ENABLE_GAMEMODE=false` to your overrides.\n\n### MangoHud\n\nhttps://github.com/flightlessmango/MangoHud\n\n\u003e [!tip]\n\u003e MangoHud is disabled by default.  \n\u003e You can enable it by adding `ENABLE_MANGOHUD=true` to your overrides.\n\n## Display Detection Support\n\nIn order to determine the settings to pass to gamescope, gamedownsights reads them\nfrom your desktop environment configuration. The following desktop environments\nare currently supported:\n\n * KDE Plasma 6 (Resolution / Refresh Rate / VRR / HDR)\n\n## Installation\n\n### With Nix\n\n```\nnix profile install github:eth-p/gamedownsights\n```\n\n## Usage\n\nTo use `gamedownsights`, add it to the launch options for the Steam game(s)\nyou want to use it with:\n\n```\ngamedownsights %command%\n```\n\n**Show detected display configuration:**\n\n```\ngamedownsights-config print\n```\n\n**Show generated gamescope command:**\n\n```\ngamedownsights-config print-launchcmd\n```\n\n## Configuration\n\nWhile `gamedownsights` is meant to work out-of-the-box, you might want to\ntweak or override some of the settings.\n\nThis can be done by creating `~/.config/gamedownsights/override.sh`.\nWhen `gamedownsights` is invoked, it will source that script to replace\nor update any settings variables.\n\n### Per-Game Configuration\n\nIf you know the AppID of the Steam game, you can override settings on a per-game basis.\n\n```bash\n# ... the rest of your override.sh config\n\n# Per-Game Settings:\ncase \"${SteamAppId:-}\" in\n1086940) # Baldur's Gate 3\n\tENABLE_GAMESCOPE=false\n\t;;\nesac\n```\n\n### Settings List\n\n\n```bash\n# The connector of the primary display. (e.g. DP-1)\n# Applies to: gamescope\nDISPLAY_PORT=''\n```\n\n```bash\n# The width and height of the primary display.\n# Applies to: gamescope\nDISPLAY_WIDTH=1920\nDISPLAY_HEIGHT=1080\n```\n\n```bash\n# The configured refresh rate of the primary display.\n# Applies to: gamescope\nDISPLAY_REFRESH_RATE=60\n```\n\n```bash\n# Enable variable refresh rate.\n# Applies to: gamescope\nDISPLAY_USE_VRR=false\n```\n\n```bash\n# Enable HDR.\n# Applies to: gamescope (or with gamescope disabled)\nDISPLAY_USE_HDR=false\n```\n\n```bash\n# Enable HDR inverse tone mapping.\n# Applies to: gamescope\nDISPLAY_ITM_NITS=300          # set to 0 to disable\n```\n\n```bash\n# Gamescope-specific settings.\n# Applies to: gamescope\nDISPLAYSERVER_PROTOCOL=x11    # currently does not have any effect\nGAMESCOPE_EXTRA_ARGS=()\n```\n\n```bash\n# Enable gamemode. (default is true)\nENABLE_GAMEMODE=true\n\n# Enable gamescope. (default is true)\nENABLE_GAMESCOPE=true\n\n# Enable mangohud. (default is false)\nENABLE_MANGOHUD=false\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feth-p%2Fgamedownsights","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feth-p%2Fgamedownsights","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feth-p%2Fgamedownsights/lists"}