{"id":42176850,"url":"https://github.com/deplicator/github-godot4-itchio","last_synced_at":"2026-01-26T21:54:15.380Z","repository":{"id":217345784,"uuid":"743280450","full_name":"deplicator/github-godot4-itchio","owner":"deplicator","description":"Example of how to push a Godot 4 project to Itch.io.","archived":false,"fork":false,"pushed_at":"2024-07-08T22:03:13.000Z","size":241,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-09T02:58:11.756Z","etag":null,"topics":["devops","game-development","gamedev","godot","godot4","itchio"],"latest_commit_sha":null,"homepage":"https://deplicator.itch.io/github-godot4-itchio","language":"GDScript","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/deplicator.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-01-14T21:24:50.000Z","updated_at":"2024-07-08T22:03:16.000Z","dependencies_parsed_at":"2024-01-15T22:39:34.899Z","dependency_job_id":"ecce3e64-143b-4cef-8e3c-0ec192081efb","html_url":"https://github.com/deplicator/github-godot4-itchio","commit_stats":null,"previous_names":["deplicator/github-godot4-itchio"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deplicator/github-godot4-itchio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deplicator%2Fgithub-godot4-itchio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deplicator%2Fgithub-godot4-itchio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deplicator%2Fgithub-godot4-itchio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deplicator%2Fgithub-godot4-itchio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deplicator","download_url":"https://codeload.github.com/deplicator/github-godot4-itchio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deplicator%2Fgithub-godot4-itchio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28789312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T21:49:50.245Z","status":"ssl_error","status_checked_at":"2026-01-26T21:48:29.455Z","response_time":59,"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":["devops","game-development","gamedev","godot","godot4","itchio"],"created_at":"2026-01-26T21:54:14.702Z","updated_at":"2026-01-26T21:54:15.374Z","avatar_url":"https://github.com/deplicator.png","language":"GDScript","readme":"# Github Actions: Godot4 -\u003e Itch.io\n\nThis is an example project with a single GitHub actions workflow to push a project to\n[Itch.io](itch.io). The project will be playable on Itch.io at\n[deplicator.itch.io/github-godot4-itchio](https://deplicator.itch.io/github-godot4-itchio) and have\na download for Linux, MacOS, and Windows.\n\n![Running on Itch.io](docs/goal.png)\n\n## Setup\n\n### Godot\n\nThe name of the Godot project and Itch.io project URL are the same. They contain no spaces or\ninvalid URL characters. They don't have to be this way, but the workflow script uses [an env called\n`PROJECT_NAME`](https://github.com/deplicator/github-godot4-itch.io/blob/afe3a1f4d3b8bd4c9aae10372dfa7d97f03ec9bf/.github/workflows/deploy.yml#L9)\nthat relies on the consistency.\n\nIn Godot Exports, [the export\nnames](https://github.com/deplicator/github-godot4-itch.io/blob/afe3a1f4d3b8bd4c9aae10372dfa7d97f03ec9bf/export_presets.cfg#L3C1-L3C1)\nuse the same name as [Itch.io Channels](https://itch.io/docs/butler/pushing.html#channel-names). The\nscript uses the channel names `html`, `linux`, `macos`, and `windows` for\n[building](https://github.com/deplicator/github-godot4-itch.io/blob/afe3a1f4d3b8bd4c9aae10372dfa7d97f03ec9bf/.github/workflows/deploy.yml#L38C15-L38C15)\nand\n[pushing](https://github.com/deplicator/github-godot4-itch.io/blob/afe3a1f4d3b8bd4c9aae10372dfa7d97f03ec9bf/.github/workflows/deploy.yml#L78)\nto Itch.io.\n\nExport path is `export/\u003cproject name\u003e-\u003cchannel\u003e.{zip|exe}`\n\n- This example uses `exports/github-godot4-itch.io-linux.zip` for linux\n- `html` is an exception, it will be `exports/html/index.html`, details in Workflow section below\n\n![Linux export example](docs/linux-export.png)\n\n### Itch.io\n\nSetup a project in Itch.io with the same url name as the Godot project.\n\n- Change **Kind of project** to HTML.\n\nUnder **Embed options**:\n\n- Change the **Viewport dimensions** to match the game\n  - This project uses Godot defaults of 1152x648\n- Check the box next to **SharedArrayBuffer support**\n  - _Note:_ This will not be playable on Safari, it's a [known\nissue](https://docs.godotengine.org/en/stable/tutorials/export/exporting_for_web.html).\n  - _Godot 4's HTML5 exports currently cannot run on macOS and iOS due to upstream bugs with\n    SharedArrayBuffer and WebGL 2.0._\n\nGet API Key by going to **User dropdown -\u003e Settings -\u003e API keys**. Generate a new API key or copy an\nexisting one. It will be used in the GitHub section next.\n\n### GitHub\n\nAdd two secretes to the repository by going to **Settings -\u003e Secrets and variables -\u003e Actions -\u003e New\nrepository secret**.\n\n- `ITCHIO_API_KEY` - API key from Itch.io (copied in previous section)\n- `ITCHIO_USERNAME` - Your Itch.io username, this doesn't have to be a secret, [it can be typed into\n  the\n  script](https://github.com/deplicator/github-godot4-itch.io/blob/afe3a1f4d3b8bd4c9aae10372dfa7d97f03ec9bf/.github/workflows/deploy.yml#L8)\n\n## Using\n\nThe workflow defined at `.github\\workflows\\deploy.yml` runs manually.\n\nIt is started by navigating to the Actions tab, choosing the workflow named `Deploy to Itch.io`,\nthen clicking the \"Run Workflow\" dropdown. From there the branch can be chosen, then click the \"Run\nworkflow\" button.\n\n![In the Action tab](docs/start-workflow.png)\n\n### Build Job\n\nBuilds the Godot project for four platforms; Linux, MacOS, Web, and Windows.\n\n- Downloads Godot and Export Templates\n- Build 4 versions of the project\n  - Zip file for Linux and MacOS\n  - Exe for Windows\n  - Several files for Web, they all get [compressed into a\n    zip](https://github.com/deplicator/github-godot4-itch.io/blob/afe3a1f4d3b8bd4c9aae10372dfa7d97f03ec9bf/.github/workflows/deploy.yml#L45)\n\n### Publish Job\n\n[Pushes\neverything](https://github.com/deplicator/github-godot4-itch.io/blob/afe3a1f4d3b8bd4c9aae10372dfa7d97f03ec9bf/.github/workflows/deploy.yml#L78C13-L78C27)\nto Itch.io using [Butler](https://itch.io/docs/butler/).\n\n### Completion\n\nWhen done, the project will be updated with the version built from this repository. Itch.io will\nalso show a notification.\n\n![Itch.io notification](docs/itchio-notificaiton.png)\n\n## Related\n\n- [Gitea Actions: Godot4 -\u003e Itch.io](https://gitea.com/deplicator/gitea-godot4-itchio)\n- [GitLab CD/CD: Godot4 -\u003e Itch.io](https://gitlab.com/deplicator/gitlab-godot4-itchio)\n- [A Related Blog Post](https://deplicator.gitlab.io/posts/2024/2-devops-for-indie-games/)\n- [And another Related Blog Post](https://deplicator.gitlab.io/posts/2024/3-more-game-related-devops/)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeplicator%2Fgithub-godot4-itchio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeplicator%2Fgithub-godot4-itchio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeplicator%2Fgithub-godot4-itchio/lists"}