{"id":46563249,"url":"https://github.com/ribbon-studios/protontweaks-db","last_synced_at":"2026-03-07T06:15:11.940Z","repository":{"id":225589919,"uuid":"766358450","full_name":"ribbon-studios/protontweaks-db","owner":"ribbon-studios","description":"Collection of tweaks for protontweaks","archived":false,"fork":false,"pushed_at":"2025-12-02T04:23:58.000Z","size":547,"stargazers_count":3,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-04T21:57:39.233Z","etag":null,"topics":["database","linux","proton","protontricks","steam"],"latest_commit_sha":null,"homepage":"https://protontweaks.com/apps","language":"TypeScript","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/ribbon-studios.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},"funding":{"github":"cecilia-sanare","kofi":"cecis"}},"created_at":"2024-03-03T03:17:13.000Z","updated_at":"2025-12-02T04:24:01.000Z","dependencies_parsed_at":"2024-04-13T23:33:42.781Z","dependency_job_id":"b4782d61-1e1d-44be-876e-bd8efd88a6ae","html_url":"https://github.com/ribbon-studios/protontweaks-db","commit_stats":null,"previous_names":["rain-cafe/protontweaks-db","ribbon-studios/protontweaks-db"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ribbon-studios/protontweaks-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ribbon-studios%2Fprotontweaks-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ribbon-studios%2Fprotontweaks-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ribbon-studios%2Fprotontweaks-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ribbon-studios%2Fprotontweaks-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ribbon-studios","download_url":"https://codeload.github.com/ribbon-studios/protontweaks-db/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ribbon-studios%2Fprotontweaks-db/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30208891,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T05:23:27.321Z","status":"ssl_error","status_checked_at":"2026-03-07T05:00:17.256Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["database","linux","proton","protontricks","steam"],"created_at":"2026-03-07T06:15:09.840Z","updated_at":"2026-03-07T06:15:11.906Z","avatar_url":"https://github.com/ribbon-studios.png","language":"TypeScript","funding_links":["https://github.com/sponsors/cecilia-sanare","cecis"],"categories":[],"sub_categories":[],"readme":"\u003e [!IMPORTANT]  \n\u003e This is the Protontweaks Database repository, you can find its sister repositories at the following links!\n\n- [CLI](https://github.com/rain-cafe/protontweaks)\n- [App](https://github.com/rain-cafe/protontweaks-ui)\n- [Database / API](https://github.com/rain-cafe/protontweaks-db) _(you are here)_\n\n## Protontweaks DB + API\n\n\u003e Tweak database for your favorite games!\n\n### Usage\n\nIts highly recommended that if you're planning on fetching tweaks from our api that you lock into a specific version.\n\n`https://api.protontweaks.com/v4/\u003capp-id\u003e.json`\n\nOld versions will get any new apps that are added, however if a feature isn't supported in the old api it won't get mapped.\n\nPrior versions will be removed approximately a year after they're added.\n\n- **V4:** Active\n- **V3:** March 1st, 2025\n- **V2:** March 1st, 2025\n- **V1:** March 1st, 2025\n\n### Adding a tweak?\n\n- Lookup your the app id of your steam app.\n\n\u003e [!TIP]\n\u003e You can discover the app id by using [https://steamdb.info](https://steamdb.info/apps/)!\n\n- Copy the contents of [template](./apps/.template.json) and create a json file with the name `[your-app-id].json`\n- Add any dlls, fonts, etc.\n- Create a PR with your changes!\n\n### Example Tweak File\n\n```ts\n{\n  \"name\": \"They Are Billions\",\n  \"tweaks\": {\n    // Specify any protontricks here\n    \"tricks\": [\"gdiplus\"],\n    // Set any environment variables here\n    \"env\": {},\n    // Set any cli args here\n    \"args\": [\"--use-d3d11\"],\n    // true      =\u003e cli is confirmed to work.\n    // false     =\u003e cli is confirmed to cause problems.\n    //\n    // If the option is not present then the given cli has not been tested.\n    // Consumers of the API can interpret this however they want.\n    // In the case of `protontweaks` it will do the following:\n    // - gamemode =\u003e run unless the user has explicitly disabled it (or it isn't installed)\n    // - mangohud =\u003e not run unless the user has explicitly enabled it and it is installed\n    //\n    // Because of how mangohud functions it tends to be safer to assume it'll cause problems unless confirmed\n    \"settings\": {\n      \"gamemode\": true,\n      \"mangohud\": false\n    },\n    \"system\": {\n      // Specify any gpu specific tweaks\n      \"gpu_driver\": {\n        \"amd\": {},\n        \"nvidia\": {}\n      }\n    }\n  },\n  // Any flags / tricks that are utilized and not overtly obvious how they resolve an issue should be documented.\n  \"issues\": [\n    {\n      \"solution\": \"--use-d3d11\",\n      \"description\": \"Renders a black screen and various other issues.\"\n    }\n  ]\n}\n```\n\n### TODO\n\n- Add support for gpu vendor specific configs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fribbon-studios%2Fprotontweaks-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fribbon-studios%2Fprotontweaks-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fribbon-studios%2Fprotontweaks-db/lists"}