{"id":13505479,"url":"https://github.com/linuxdeploy/linuxdeploy","last_synced_at":"2026-03-07T21:15:46.677Z","repository":{"id":38150672,"uuid":"134625865","full_name":"linuxdeploy/linuxdeploy","owner":"linuxdeploy","description":"AppDir creation and maintenance tool. Featuring flexible plugin system.","archived":false,"fork":false,"pushed_at":"2025-11-07T19:38:48.000Z","size":681,"stargazers_count":683,"open_issues_count":99,"forks_count":92,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-11-07T21:15:45.996Z","etag":null,"topics":["appimage","cpp","linuxdeploy"],"latest_commit_sha":null,"homepage":"https://github.com/linuxdeploy/linuxdeploy","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/linuxdeploy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2018-05-23T21:10:25.000Z","updated_at":"2025-11-07T19:20:12.000Z","dependencies_parsed_at":"2023-02-01T06:31:12.190Z","dependency_job_id":"945c7d11-0422-4132-ac2f-2cfe53ffeb58","html_url":"https://github.com/linuxdeploy/linuxdeploy","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/linuxdeploy/linuxdeploy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxdeploy%2Flinuxdeploy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxdeploy%2Flinuxdeploy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxdeploy%2Flinuxdeploy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxdeploy%2Flinuxdeploy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linuxdeploy","download_url":"https://codeload.github.com/linuxdeploy/linuxdeploy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxdeploy%2Flinuxdeploy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30231502,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T19:01:10.287Z","status":"ssl_error","status_checked_at":"2026-03-07T18:59:58.103Z","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":["appimage","cpp","linuxdeploy"],"created_at":"2024-08-01T00:01:08.787Z","updated_at":"2026-03-07T21:15:46.645Z","avatar_url":"https://github.com/linuxdeploy.png","language":"C++","readme":"# linuxdeploy\n\nAppDir creation and maintenance tool.\n\n\n## About\n\nAppImages are a well known and quite popular format for distributing applications from developers to end users.\n\n[appimagetool](https://github.com/AppImage/AppImageKit), the tool creating AppImages, expects directories in a specific format that will then be converted into the final AppImage. This format is called [AppDir](https://github.com/TheAssassin/linuxdeploy/wiki/AppDir-specification). It is not very difficult to understand, but creating AppDirs for arbitrary applications tends to be a very repetitive task. Also, bundling all the dependencies properly can be a quite difficult task. It seems like there is a need for tools which simplify these tasks.\n\nlinuxdeploy is designed to be an AppDir maintenance tool. It provides extensive functionalities to create and bundle AppDirs for applications. It features a plugin system that allows for easy bundling of frameworks and creating output bundles such as AppImages with little effort.\n\nlinuxdeploy was greatly influenced by [linuxdeployqt](https://github.com/probonopd/linuxdeployqt), and while it employs stricter rules on AppDirs, it's more flexible in use. If you use linuxdeployqt at the moment, consider switching to linuxdeploy today!\n\n\n## User guides and examples\n\nPlease see the [linuxdeploy user guide](https://docs.appimage.org/packaging-guide/from-source/linuxdeploy-user-guide.html) and the [native binaries packaging guide](https://docs.appimage.org/packaging-guide/from-source/native-binaries.html) in the [AppImage documentation](https://docs.appimage.org). There's also an [examples section](https://docs.appimage.org/packaging-guide/from-source/native-binaries.html#examples).\n\n\n## Projects using linuxdeploy\n\nThis is an incomplete list of projects using linuxdeploy. You might want to read their build scripts to see how they use linuxdeploy.\n\n- [Pext](https://github.com/Pext/Pext)\n- [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher)\n- [OpenRCT2](https://github.com/OpenRCT2/OpenRCT2)\n- [AppImageUpdate](https://github.com/AppImage/AppImageUpdate)\n- [appimaged](https://github.com/AppImage/appimaged)\n- [MediaElch](https://github.com/Komet/MediaElch/)\n- [CPU-X](https://github.com/X0rg/CPU-X) (details available [here](https://github.com/AppImage/AppImageKit/wiki/Bundling-GTK3-apps#fully-automated-deployment-from-sources-with-github-actions-cpu-x))\n\n\n## Plugins\n\nlinuxdeploy features a plugin system. Plugins are separate executables which implement a CLI-based plugin interface ([specification](https://github.com/TheAssassin/linuxdeploy/wiki/Plugin-system)).\n\nThere are two types of plugins: bundling and output plugins. Bundling plugins can be used to add resources to the AppDir. Output plugins turn the AppDir in actual bundles, e.g., AppImages.\n\nlinuxdeploy looks for plugins in the following places:\n\n  - the directory containing the linuxdeploy binary\n  - when using the AppImage: the directory containing the AppImage\n  - the directories in the user's `$PATH`\n\nYou can use `./linuxdeploy*.AppImage --list-plugins` to get a list of all the plugins linuxdeploy has detected on your system.\n\nlinuxdeploy currently ships with some plugins. These are likely out of date. In case of issues, please download the latest version, which will take precendence over the bundled plugin.\n\nIf you want to use a plugin to bundle additional resources, please add `./linuxdeploy*.AppImage --plugin \u003cname\u003e` to your linuxdeploy command. Output plugins can be activated using `./linuxdeploy*.AppImage --output \u003cname\u003e`.\n\n**A list of official and community plugins can be found in the [awesome-linuxdeploy](http://github.com/linuxdeploy/awesome-linuxdeploy) project.**\n\n**Note:** If you want to suggest a plugin for a specific framework, language etc., please feel free to [create a new issue](https://github.com/linuxdeploy/linuxdeploy/issues/new). Current plugin requests can be found [here](https://github.com/linuxdeploy/linuxdeploy/issues?utf8=%E2%9C%93\u0026q=label%3A%22plugin+request%22).\n\n\n## Troubleshooting\n\n\u003e I bundled additional resources, but when I try to run them, either the system binary is called or the file is not found.\n\nlinuxdeploy does not change any environment variables such as `$PATH`. Your application **must** search for additional resources such as icon files or executables relative to the main binary.\n\n\n## Contact\n\nThe easiest way to get in touch with the developers is to join the IRC chatroom [#AppImage](https://web.libera.chat/#appimage) on [https://libera.chat](Libera.Chat). This is the preferred way for general feedback or questions how to use this application.\n\nTo report problems, please [create an issue](https://github.com/linuxdeploy/linuxdeploy/issues/new) on GitHub.\n\nContributions welcome! Please feel free to fork this repository and send us a pull request. Even small changes, e.g., in this README, are highly appreciated!\n","funding_links":[],"categories":["C++","AppImage developer tools"],"sub_categories":["Deployment tools for compiled applications"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxdeploy%2Flinuxdeploy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinuxdeploy%2Flinuxdeploy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxdeploy%2Flinuxdeploy/lists"}