{"id":21299799,"url":"https://github.com/ericoporto/agsconfig","last_synced_at":"2025-07-22T13:33:31.518Z","repository":{"id":85938951,"uuid":"234664558","full_name":"ericoporto/agsconfig","owner":"ericoporto","description":"agsconfig tries to give similar functionality to the traditional winsetup.exe of Adventure Game Studio, but cross platform","archived":false,"fork":false,"pushed_at":"2020-06-15T15:28:28.000Z","size":7178,"stargazers_count":9,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-11T19:39:17.499Z","etag":null,"topics":["adventure-game-studio","adventuregamestudio","ags","ags-engine","cross-platform","imgui","linux","macos"],"latest_commit_sha":null,"homepage":"https://www.adventuregamestudio.co.uk/forums/index.php?topic=57717.0","language":"C","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/ericoporto.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":"2020-01-18T01:23:31.000Z","updated_at":"2024-03-08T13:50:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"308b3110-5af7-49d7-8a7d-fedebbeb5373","html_url":"https://github.com/ericoporto/agsconfig","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ericoporto/agsconfig","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoporto%2Fagsconfig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoporto%2Fagsconfig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoporto%2Fagsconfig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoporto%2Fagsconfig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ericoporto","download_url":"https://codeload.github.com/ericoporto/agsconfig/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoporto%2Fagsconfig/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266506134,"owners_count":23940019,"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-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["adventure-game-studio","adventuregamestudio","ags","ags-engine","cross-platform","imgui","linux","macos"],"created_at":"2024-11-21T15:06:11.491Z","updated_at":"2025-07-22T13:33:31.512Z","avatar_url":"https://github.com/ericoporto.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agsconfig\n\n[![Build Status](https://dev.azure.com/ericoporto/agsconfig/_apis/build/status/ericoporto.agsconfig?branchName=master)](https://dev.azure.com/ericoporto/agsconfig/_build/latest?definitionId=13\u0026branchName=master)\n\nagsconfig tries to give similar functionality to the traditional winsetup.exe of Adventure Game Studio, but cross platform\n\n![](https://user-images.githubusercontent.com/2244442/74112534-41314f80-4b7c-11ea-9ff3-b13c402a59ec.png)\n\n## Using with your game\n\nPlace `agsconfig` executable at the same location of your game entry-point (`mygame`) or binary (`mygame.exe`). \nOn MacOS, place it at the side of the AGS Engine binary.\n\nAdd on the same directory a `.config` file, and add the following content to it:\n\n```\n[game]\nexecutable = mygame\n```\n\nOn MacOS, set the value of the executable to the binary of the AGS Engine and certify the AGS Engine is finding your \ngame on execution. For now, it also requires marking it as executable with `chmod +x agsconfig` - or the name you set for this utility.\n\nIf you are making an Adventure Game Studio with Joystick compatibility, this tool also has gamepad controls supplied by ImGui, which should make possible to configure your AGS game and launch it from your sofa.\n\n## Embedded project libraries\n\nThis project uses the following libraries that are already supplied in the repository for simplicity\n\n- SDL2-2.0.10\n- ImGui\n- inipp\n- tiny-process-library\n- optional-lite\n- dirent (Windows compatibility)\n\n## Dependencies\n\nThis project uses CMake as a build system, at least version 3.13, so you will have to install it. It should just work with the CMake provided by CLion, so should just load it if editing on it. On Visual Studio, you need to install the CMake tools provided by the Visual Studio installer, and later open this directory through open folder, [more details supplied on it's official docs...](https://docs.microsoft.com/en-us/cpp/build/cmake-projects-in-visual-studio?view=vs-2019#ide-integration). On MacOS you will need XCode installed.\n\nOn Linux, you will need additionally the packages `libgl1-mesa-dev` and `mesa-common-dev` (both are available in apt and provide libGL and libdl, needed for linking).\n\n### Building on Ubuntu Desktop\n\nTo build agsconfig and all the libraries here you may need to install the following dependencies\n```\nsudo apt-get -y install libdbus-glib-1-2 libdbus-glib-1-dev libasound2-dev libpulse-dev libsndio-dev libxcursor-dev libxinerama-dev install libxi-dev dbus libdbus-1-dev libudev-dev libibus-1.0-dev\n```\n\n## License\n\nAGS Config is made by Érico Vieira Porto and provided with MIT license, see [`LICENSE`](https://github.com/ericoporto/agsconfig/blob/master/LICENSE).\n\nSDL (Simple DirectMedia Layer) is by Sam Lantinga and provided with it's own license, see [`COPYING.txt`](https://github.com/ericoporto/agsconfig/blob/master/libs/SDL2-2.0.10/COPYING.txt).\n\nDear ImGui is made by Omar Cornut and provided with MIT license, see [`LICENSE.txt`](https://github.com/ericoporto/agsconfig/blob/master/libs/imgui/LICENSE.txt).\n\nIniPP is made by Matthias C. M. Troffaes and provided with MIT license, see [`LICENSE.txt`](https://github.com/ericoporto/agsconfig/blob/master/libs/inipp/LICENSE.txt).\n\noptional lite is distributed under the Boost Software License, see [`LICENSE.txt`](https://github.com/ericoporto/agsconfig/blob/master/libs/optional-lite/LICENSE.txt).\n\ntiny-process-library is made by Ole Christian Eidheim and provided with MIT license, see [`LICENSE`](https://github.com/ericoporto/agsconfig/blob/master/libs/tiny-process-library/LICENSE).\n\nDirent Windows interface is made by Toni Ronkko and provided with MIT license, see [`LICENSE`](https://github.com/ericoporto/agsconfig/blob/master/libs/dirent/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericoporto%2Fagsconfig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericoporto%2Fagsconfig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericoporto%2Fagsconfig/lists"}