{"id":14965102,"url":"https://github.com/revolutionary-games/thrive-launcher","last_synced_at":"2025-04-08T12:07:37.934Z","repository":{"id":19872131,"uuid":"88083085","full_name":"Revolutionary-Games/Thrive-Launcher","owner":"Revolutionary-Games","description":"Thrive Launcher for installing and automatically updating Thrive","archived":false,"fork":false,"pushed_at":"2025-04-07T06:39:56.000Z","size":5317,"stargazers_count":296,"open_issues_count":77,"forks_count":37,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-04-08T12:07:31.767Z","etag":null,"topics":["avalonia","launcher","linux","thrive"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Revolutionary-Games.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","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":"thrivegame","custom":"https://revolutionarygamesstudio.com/donate/"}},"created_at":"2017-04-12T18:20:29.000Z","updated_at":"2025-04-08T05:28:26.000Z","dependencies_parsed_at":"2023-12-21T09:30:26.863Z","dependency_job_id":"b1415100-661a-4d99-960a-01a306307ff8","html_url":"https://github.com/Revolutionary-Games/Thrive-Launcher","commit_stats":{"total_commits":1366,"total_committers":81,"mean_commits":"16.864197530864196","dds":0.4048316251830161,"last_synced_commit":"3b912f5d7fd4668f4c0532d717eaba1b1efe236c"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Revolutionary-Games%2FThrive-Launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Revolutionary-Games%2FThrive-Launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Revolutionary-Games%2FThrive-Launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Revolutionary-Games%2FThrive-Launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Revolutionary-Games","download_url":"https://codeload.github.com/Revolutionary-Games/Thrive-Launcher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247838444,"owners_count":21004580,"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":["avalonia","launcher","linux","thrive"],"created_at":"2024-09-24T13:34:13.462Z","updated_at":"2025-04-08T12:07:37.904Z","avatar_url":"https://github.com/Revolutionary-Games.png","language":"C#","funding_links":["https://patreon.com/thrivegame","https://revolutionarygamesstudio.com/donate/"],"categories":[],"sub_categories":[],"readme":"Thrive Launcher\n===============\n\n### [Build Status](https://dev.revolutionarygamesstudio.com/ci/2)\n\nThrive launcher is a desktop application that manages downloading and\ninstalling the game releases.\n\nFor more information, visit [Revolutionary Games' Website](http://revolutionarygamesstudio.com/), \n[Thrive repository](https://github.com/Revolutionary-Games/Thrive).\n\n\n\n### Requirements on Linux\n\nOn Linux it is recommended to use the [Flatpak\nversion](https://flathub.org/apps/com.revolutionarygamesstudio.ThriveLauncher)\nof the launcher.\n\nFor the manually installable version a distro that is as new as\nAlmaLinux 9 is required.\n\n\n### Required Windows version\n\nDue to the used framework at least Windows 10 or newer is\nrequired. Windows 7 may still work for some time before new .NET\nversions no longer run on it.\n\nReleases\n--------\n\nReleases are available here:\n[Thrive-Launcher releases](https://github.com/Revolutionary-Games/Thrive-Launcher/releases)\n\n\nBuilding\n--------\n\nIf you can't find a precompiled release or you want to develop the\nlauncher you will need to follow these instructions to build it.\n\n### Dependencies\n\nIn order to properly clone this repository you need to make sure you\nhave [Git LFS](https://git-lfs.github.com/) installed.\n\nYou first need dotnet sdk before you can build Thrive Launcher. So\ncheck [here](https://dotnet.microsoft.com/en-us/download)\nhow to install it.\n\n### Downloading\n\nFirst clone this repository with `git clone\nhttps://github.com/Revolutionary-Games/Thrive-Launcher.git --recursive` now go to\nthe created directory and run `dotnet restore` this should install all\nrequired packages. You may need to run this again after pulling updates\nif your IDE doesn't do so automatically.\n\n### Icons\n\nIn order for the icons to work you need to run `dotnet run --project\nScripts -- icons` to create all the icon files from the source\nimages. The icon creation script requires you to have\n[ImageMagick](https://www.imagemagick.org/) installed. On Windows add\nthe folder with `magick.exe` to the PATH environment variable\nmanually.\n\n### Running\n\nNow you should have everything set up. You can run Thrive launcher\nwith `dotnet run` in the `Thrive-Launcher/ThriveLauncher`\nsubdirectory. Or use a C# IDE to open the project files to run.\n\n### Issues\n\nIf you have issues first make sure that dotnet SDK is properly\ninstalled and you have ran `dotnet restore` in the launcher's folder.\n\n\nCreating releases\n-----------------\n\nThis section details what to do to create Launcher packages and\ninstallers. Note that due to various limitations you need to make the\npackages for each platform on that respective platform, which means\nyou need a Windows, Linux, and Mac systems.\n\nThe following extra tools are needed for creating packages on Linux:\n```sh\npodman\n```\n\nIf required on Linux, Rcedit can be downloaded from\n[here](https://github.com/electron/rcedit/releases).\n\n\nOn Windows creating packages requires:\n- Icons being generated (see above)\n- NSIS, needs to be added to PATH\n\nTo create build containers for Linux:\n\n```sh\ndotnet run --project Scripts -- container --export false --image ReleaseBuilder latest\n```\n\nOn Mac you need the xcode tools installed as well as allowing\nterminal / your IDE to automate Finder.\n\n### Packaging\n\nWith the build containers created on Linux or on other platforms with\ntheir requirements fullfilled, run the following:\n\n```sh\ndotnet run --project Scripts -- package\n```\n\n### After packaging\n\nBefore publishing test that the created builds didn't have broken\npackages. If they did a clean needs to be run and then the packaging\nagain:\n```sh\ndotnet run --project Scripts -- clean\ndotnet run --project Scripts -- package\n```\n\nTo test on Linux, do not build with podman as that always results in\nclean working builds, but other builds might be broken. So build\nnatively on the current platform and test the launcher works:\n```\ndotnet run --project Scripts -- package --compress false --podman false Linux\n```\n\nCI Images\n---------\n\nCI image can be created with the container script like this:\n\n```sh\ndotnet run --project Scripts -- container --image CI 3\n```\n\nMiscellaneous\n-------------\n\n### Updating Copyright Year\n\nWhen updating the copyright year it needs to be updated in\n`LICENSE.md` and also in `ThriveLauncher/ThriveLauncher.csproj`.\n\n### Updating dotnet version\n\nCurrently version 8 is used. If updated the installer files in\n`DependencyInstallers` need to be updated and `PackageTool` as well as\n`Scripts/launcher.nsi.template` need to be updated to refer to the new version.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevolutionary-games%2Fthrive-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frevolutionary-games%2Fthrive-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevolutionary-games%2Fthrive-launcher/lists"}