{"id":20563243,"url":"https://github.com/gazebosim/gz-launch","last_synced_at":"2026-03-11T10:04:58.576Z","repository":{"id":37047236,"uuid":"255865289","full_name":"gazebosim/gz-launch","owner":"gazebosim","description":"Run and manage programs and plugins.","archived":false,"fork":false,"pushed_at":"2026-01-27T14:46:25.000Z","size":2558,"stargazers_count":16,"open_issues_count":18,"forks_count":21,"subscribers_count":6,"default_branch":"gz-launch9","last_synced_at":"2026-01-31T14:39:51.509Z","etag":null,"topics":["cpp","gazebo","gazebosim","hacktoberfest","ignition-launch","ignition-libraries","ignition-robotics","process-manager","robotics"],"latest_commit_sha":null,"homepage":"https://gazebosim.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gazebosim.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-04-15T09:17:56.000Z","updated_at":"2026-01-08T22:59:26.000Z","dependencies_parsed_at":"2023-12-21T01:57:46.663Z","dependency_job_id":"8c988be4-c785-41a6-afd7-0e94a7d288f5","html_url":"https://github.com/gazebosim/gz-launch","commit_stats":{"total_commits":452,"total_committers":33,"mean_commits":"13.696969696969697","dds":0.7787610619469026,"last_synced_commit":"c09ee8c2ca041f1f777e985e007761e3b2a7bf4f"},"previous_names":["ignitionrobotics/ign-launch"],"tags_count":61,"template":false,"template_full_name":null,"purl":"pkg:github/gazebosim/gz-launch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gazebosim%2Fgz-launch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gazebosim%2Fgz-launch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gazebosim%2Fgz-launch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gazebosim%2Fgz-launch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gazebosim","download_url":"https://codeload.github.com/gazebosim/gz-launch/tar.gz/refs/heads/gz-launch9","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gazebosim%2Fgz-launch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30377838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T06:09:32.197Z","status":"ssl_error","status_checked_at":"2026-03-11T06:09:17.086Z","response_time":84,"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":["cpp","gazebo","gazebosim","hacktoberfest","ignition-launch","ignition-libraries","ignition-robotics","process-manager","robotics"],"created_at":"2024-11-16T04:17:11.343Z","updated_at":"2026-03-11T10:04:58.558Z","avatar_url":"https://github.com/gazebosim.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gazebo Launch : Run and manage programs and plugins\n\n**Maintainer:** nate AT openrobotics DOT org\n\n[![GitHub open issues](https://img.shields.io/github/issues-raw/gazebosim/gz-launch.svg)](https://github.com/gazebosim/gz-launch/issues)\n[![GitHub open pull requests](https://img.shields.io/github/issues-pr-raw/gazebosim/gz-launch.svg)](https://github.com/gazebosim/gz-launch/pulls)\n[![Discourse topics](https://img.shields.io/discourse/https/community.gazebosim.org/topics.svg)](https://community.gazebosim.org)\n[![Hex.pm](https://img.shields.io/hexpm/l/plug.svg)](https://www.apache.org/licenses/LICENSE-2.0)\n\nBuild | Status\n-- | --\nTest coverage | [![codecov](https://codecov.io/gh/gazebosim/gz-launch/tree/gz-launch8/graph/badge.svg)](https://codecov.io/gh/gazebosim/gz-launch/branch/gz-launch8)\nUbuntu Noble  | [![Build Status](https://build.osrfoundation.org/buildStatus/icon?job=gz_launch-ci-gz-launch8-noble-amd64)](https://build.osrfoundation.org/job/gz_launch-ci-gz-launch8-noble-amd64)\nHomebrew      | [![Build Status](https://build.osrfoundation.org/buildStatus/icon?job=gz_launch-ci-gz-launch8-homebrew-amd64)](https://build.osrfoundation.org/job/gz_launch-ci-gz-launch8-homebrew-amd64)\nWindows       | [![Build Status](https://build.osrfoundation.org/buildStatus/icon?job=gz_launch-8-clowin)](https://build.osrfoundation.org/job/gz_launch-8-clowin)\n\nGazebo Launch, a component of [Gazebo](https://gazebosim.org), provides a command line interface\nto run and manage application and plugins.\n\n# Table of Contents\n\n[Features](#features)\n\n[Install](#install)\n\n[Usage](#usage)\n\n[Documentation](#documentation)\n\n[Folder Structure](#folder-structure)\n\n[Contributing](#contributing)\n\n[Code of Conduct](#code-of-conduct)\n\n[Versioning](#versioning)\n\n[License](#license)\n\n# Features\n\nGazebo Launch is used to run and manage plugins and programs. A\nconfiguration script can be used to specify which programs and plugins to\nexecute. Alternatively, individual programs and plugins can be run from the\ncommand line. Example configuration scripts are located in the `examples`\ndirectory.\n\n1. Automatic ERB parsing of configuration files.\n1. Pass arguments to launch files from the command line.\n1. Plugins to launch Gazebo Sim, joystick interface, and a websocket server for\n   simulation.\n\n# Install\n\nSee the [installation tutorial](https://gazebosim.org/api/launch/8/install.html).\n\n# Usage\n\nSample launch configuration files are in the [examples directory](https://github.com/gazebosim/gz-launch/blob/gz-launch8/examples/).\n\n**Example**\n\n1. Run a configuration that launches [Gazebo](https://gazebosim.org/libs/sim/).\n\n    ```\n    gz launch sim.gzlaunch\n    ```\n\n## Known issue of command line tools\n\nIn the event that the installation is a mix of Debian and from source, command\nline tools from `gz-tools` may not work correctly.\n\nA workaround is to define the environment variable\n`GZ_CONFIG_PATH` to point to the different locations of the Gazebo libraries installations,\nwhere the YAML files for the packages are found, such as\n```\nexport GZ_CONFIG_PATH=/usr/local/share/gz:$HOME/ws/install/share/gz\n```\n\nwhere `$HOME/ws` is an example colcon workspace used to build Gazebo\n\n# Documentation\n\nSee the [installation tutorial](https://gazebosim.org/api/launch/8/install.html).\n\n# Folder Structure\n\nRefer to the following table for information about important directories and files in this repository.\n\n```\ngz-launch\n├── examples                 Example launch configurations.\n├── include/gz/launch  Header files.\n├── plugins                  Launch plugins, one per subdirectory.\n├── src                      Source files and unit tests.\n├── test\n│    ├── integration         Integration tests.\n│    ├── performance         Performance tests.\n│    └── regression          Regression tests.\n├── tools                    Some useful tools such as linters\n├── tutorials                Tutorials\n├── Changelog.md             Changelog.\n└── CMakeLists.txt           CMake build script.\n```\n\n# Contributing\n\nPlease see the [contribution guide](https://gazebosim.org/docs/all/contributing).\n\n# Code of Conduct\n\nPlease see\n[CODE_OF_CONDUCT.md](https://github.com/gazebosim/gz-sim/blob/main/CODE_OF_CONDUCT.md).\n\n# Versioning\n\nThis library uses [Semantic Versioning](https://semver.org/). Additionally, this library is part of the [Gazebo project](https://gazebosim.org) which periodically releases a versioned set of compatible and complimentary libraries. See the [Gazebo website](https://gazebosim.org) for version and release information.\n\n# License\n\nThis library is licensed under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0). See also the [LICENSE](https://github.com/gazebosim/gz-launch/blob/main/LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgazebosim%2Fgz-launch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgazebosim%2Fgz-launch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgazebosim%2Fgz-launch/lists"}