{"id":21739449,"url":"https://github.com/daviddesimone/opencloudsaves","last_synced_at":"2025-10-02T16:31:04.257Z","repository":{"id":65964777,"uuid":"582196187","full_name":"DavidDeSimone/OpenCloudSaves","owner":"DavidDeSimone","description":"A tool used for syncing your save games across your devices ","archived":false,"fork":false,"pushed_at":"2023-05-01T06:57:25.000Z","size":22915,"stargazers_count":356,"open_issues_count":24,"forks_count":8,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-01-14T17:49:18.566Z","etag":null,"topics":["cloud","cross-platform","games","golang","save-files","save-manager","savegame","steam","windows"],"latest_commit_sha":null,"homepage":"","language":"Go","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/DavidDeSimone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"DavidDeSimone# Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-12-26T03:38:44.000Z","updated_at":"2025-01-13T16:03:06.000Z","dependencies_parsed_at":"2024-01-05T23:45:15.706Z","dependency_job_id":"35bfd934-e38d-4e58-a05d-2809ec029d15","html_url":"https://github.com/DavidDeSimone/OpenCloudSaves","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidDeSimone%2FOpenCloudSaves","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidDeSimone%2FOpenCloudSaves/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidDeSimone%2FOpenCloudSaves/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidDeSimone%2FOpenCloudSaves/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DavidDeSimone","download_url":"https://codeload.github.com/DavidDeSimone/OpenCloudSaves/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235021564,"owners_count":18923608,"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":["cloud","cross-platform","games","golang","save-files","save-manager","savegame","steam","windows"],"created_at":"2024-11-26T06:09:06.459Z","updated_at":"2025-10-02T16:31:03.489Z","avatar_url":"https://github.com/DavidDeSimone.png","language":"Go","funding_links":["https://github.com/sponsors/DavidDeSimone# Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]"],"categories":[],"sub_categories":[],"readme":"# Open Cloud Saves \n\nThis project is now archived - the code and binaries are available, but we are not accepting PRs or change sets. \n\nOpen Cloud Saves is an open source application for managing your saves games across Windows, MacOS, and Linux (including SteamOS). Open Cloud Saves is available for use officially as a “beta”. As a beta test, we recommend that you manually make a backup of your save data before usage. Until Open Cloud Save is more battle tested, we will issue a warning for users to use caution with “critical, beloved” save data.\n\nOpen Cloud Save gives an advantage over existing cloud solutions:\n\n1. Allows cloud saves for games without developer support\n2. Allows for the inclusion of only certain files or filetypes. This can prevent games syncing graphical settings in addition to syncing save data.\n3. Allows for sync between storefronts (you own a Steam on linux and a Epic Game Store version on windows\n\nKey Features:\n\n1. Inclusion of specific save files based on [pattern matching](https://rclone.org/filtering/)\n2. Customizable save data locations - you can tailor the app to your specific save locations\n3. Ability to create new save definitions - you do not need to wait for developers to support cloud saves for their games.\n4. Data protection - by default, OpenCloudSave will perform a dry-run before all syncs. This way you can see what changes will be made to your save data before they happen. (You can disable this functionality if you just want to immediately sync)\n\n\u003cp align=\"center\"\u003e\n\n![image](https://user-images.githubusercontent.com/7245174/218942321-510179b1-1f18-4ea6-8e91-6cbabae63672.png)\n\n\u003c/p\u003e\n\n\n# Install\n\n## Linux / Steam Deck\n\n1. We are now listed on [Flathub](https://flathub.org/apps/details/io.github.daviddesimone.opencloudsaves) and the Discover store on steam deck. We recommend downloading through flathub or the discover store on steam deck!\n\nFor power users we offer a precompiled binary for [x86_64 in .tar.gz format](https://github.com/DavidDeSimone/OpenCloudSaves/releases/download/v0.18.1/linux_opencloudsave_0.18.1_x86_64.tar.gz). \n\n## Windows\n\n1. Download the [Open Cloud Save Installer](https://github.com/DavidDeSimone/OpenCloudSaves/releases/download/v0.18.1/windows_opencloudsave_0.18.1_x86_64.msi)\n2. Follow the instructions for installation.\n3. Launch opencloudsave.exe located in C:\\Program Files\\OpenCloudSave\\\n\nNOTE: There is a chance that windows defender or your AV may flag this application as a \"virus\". This is a consequence of the application being written in golang. Windows marks a lot of golang applications as viruses, as documented here: \nhttps://go.dev/doc/faq#virus\n\nThis application is free and open source, and is free to audit.\n\n## MacOS\n1. Download the [Open Cloud Save .dmg](https://github.com/DavidDeSimone/OpenCloudSaves/releases/download/v0.18.1/macos_opencloudsaves_0.18.1_aarch64.dmg)\n2. Drag the executable into your /Applications/ directory\n3. Launch OpenCloudSave\n\n\n## Build\n\nOn all platforms, you will need to initialize the rclone submodule:\n\n```\ngit submodule update --init\n```\n\n### Windows\n\nFor windows builds, you will need [MSYS2](https://www.msys2.org/). Specifically, you will need MINGW64 \n\nYou will also need to download Webview 2 - https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section. This is a runtime requirement that is usually downloaded by our MSI installer. If you haven't already installed OpenCloudSave, you will need to download WebView2 to run your compiled application. \n\nRun\n```bash\npacman -S mingw-w64-x86_64-go\nPATH=$PATH:/mingw64/bin/\nexport GOROOT=/mingw64/lib/go\nexport GOPATH=/mingw64\n```\n\nYou will likely want to add these to your shell start up script.\n\nValidate that go is installed correctly with\n```bash\ngo version\n```\n\nYou will also need gcc:\n```bash\npacman -S mingw-w64-x86_64-gcc\n```\n\n\nNOTE: Running our build script will install go-winres. go-winres is a tool that will compile things like our icon into our application. You can inspect the code at https://github.com/tc-hib/\n\nFrom there, you can run:\n```bash\n./build/win/build.sh\n./build/win/opencloudsave.exe\n```\n\nIf you would like to view the console logs of the application, you can build via:\n\n```bash\n./build/win/build.sh debug\n```\n\nTo build the MSI, you will need WiX toolset v3.11. https://wixtoolset.org/\n\nOnce installed, run:\n\n```bash\n./build/win/package.sh\n```\n\nThis will create the MSI in the build/win directory.\n\n### MacOS\n\nFor this build, you will need golang and a C compiler. \n\nYou may need to install xcode command line tools if you haven't already:\n\n`xcode-select --install`\n\nTo build, you will need to run \n```bash\ngo build\n```\n\nFrom there, you can run \n```bash\n./opencloudsave\n```\n\nTo package the finished application, you can run\n```bash\n./build/macos/build.sh\n```\n\nThis will compile a macOS application (as opencloudsave.app) and a DMG for distribution.\n\n### Linux\n\nWe support both a direct golang build, and a flatpak build\n\n#### Local Build\n\nIn addition to golang, you will need the following deps depending on your distro:\n\nDebian / Ubuntu: \n```\nsudo apt-get install golang gcc libgl1-mesa-dev xorg-dev libgtk-3-dev webkit2gtk-4.0\n```\n\nFrom there you can run \n```bash\ngo build\n./opencloudsave\n```\n\n#### Flatpak\n\nFor this example, you will need [flatpak](https://flatpak.org/setup/). This assumes you have basic familiarity with flatpak, but if  you do not, you should be up to speed after running flatpak's getting started. \n\nYou can run \n```bash\n./build/linux/package-local.bash\n```\n\nThis will build the flatpak - from there you can install it and run the flatpak version. `package-local` builds off of the current state of the repo, so you can iterate and build the app without needing to install any deps beside flatpak and flatpak-builder.\n\n\nThe following command builds the \"release\" version of the app. This is tied to a specific commit to ensure that the build is reproducible. \n```bash\n./build/linux/package.bash\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaviddesimone%2Fopencloudsaves","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaviddesimone%2Fopencloudsaves","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaviddesimone%2Fopencloudsaves/lists"}