{"id":27301476,"url":"https://github.com/eprosima/fast-dds-spy","last_synced_at":"2025-07-27T04:08:03.365Z","repository":{"id":131102919,"uuid":"607072601","full_name":"eProsima/Fast-DDS-spy","owner":"eProsima","description":"eProsima Fast DDS Spy is a CLI interactive tool that allows to introspect a DDS network in human readable format. Looking for commercial support? Contact info@eprosima.com","archived":false,"fork":false,"pushed_at":"2025-07-21T10:45:06.000Z","size":2424,"stargazers_count":13,"open_issues_count":3,"forks_count":5,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-07-21T12:27:40.680Z","etag":null,"topics":["dds","eprosima","fastdds","middleware","ros2"],"latest_commit_sha":null,"homepage":"https://eprosima.com","language":"C++","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/eProsima.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":"2023-02-27T08:55:29.000Z","updated_at":"2025-07-16T09:46:38.000Z","dependencies_parsed_at":"2024-01-16T09:43:34.065Z","dependency_job_id":"25dd8653-ea48-4f64-a386-9f4097757738","html_url":"https://github.com/eProsima/Fast-DDS-spy","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/eProsima/Fast-DDS-spy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eProsima%2FFast-DDS-spy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eProsima%2FFast-DDS-spy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eProsima%2FFast-DDS-spy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eProsima%2FFast-DDS-spy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eProsima","download_url":"https://codeload.github.com/eProsima/Fast-DDS-spy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eProsima%2FFast-DDS-spy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267298756,"owners_count":24065889,"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-27T02:00:11.917Z","response_time":82,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["dds","eprosima","fastdds","middleware","ros2"],"created_at":"2025-04-12T01:46:13.939Z","updated_at":"2025-07-27T04:08:03.340Z","avatar_url":"https://github.com/eProsima.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Fast DDS](resources/images/github_banner_fastddsspy.png)](https://eprosima.com/middleware/tools/fast-dds-spy)\n\n\u003cbr\u003e\n\n\u003cdiv class=\"menu\" align=\"center\"\u003e\n    \u003cstrong\u003e\n        \u003ca href=\"https://eprosima.com/index.php/downloads-all\"\u003eDownload\u003c/a\u003e\n        \u003cspan\u003e\u0026nbsp;\u0026nbsp;•\u0026nbsp;\u0026nbsp;\u003c/span\u003e\n        \u003ca href=\"https://fast-dds-spy.readthedocs.io/en/latest/\"\u003eDocs\u003c/a\u003e\n        \u003cspan\u003e\u0026nbsp;\u0026nbsp;•\u0026nbsp;\u0026nbsp;\u003c/span\u003e\n        \u003ca href=\"https://eprosima.com/index.php/company-all/news\"\u003eNews\u003c/a\u003e\n        \u003cspan\u003e\u0026nbsp;\u0026nbsp;•\u0026nbsp;\u0026nbsp;\u003c/span\u003e\n        \u003ca href=\"https://twitter.com/EProsima\"\u003eTwitter\u003c/a\u003e\n        \u003cspan\u003e\u0026nbsp;\u0026nbsp;•\u0026nbsp;\u0026nbsp;\u003c/span\u003e\n        \u003ca href=\"mailto:info@eprosima.com\"\u003eContact Us\u003c/a\u003e\n    \u003c/strong\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cdiv class=\"badges\" align=\"center\"\u003e\n    \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/eProsima/Fast-DDS-Spy.svg\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/eProsima/Fast-DDS-Spy/releases\"\u003e\u003cimg alt=\"Releases\" src=\"https://img.shields.io/github/v/release/eProsima/Fast-DDS-Spy?sort=semver\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/eProsima/Fast-DDS-Spy/issues\"\u003e\u003cimg alt=\"Issues\" src=\"https://img.shields.io/github/issues/eProsima/Fast-DDS-Spy.svg\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/eProsima/Fast-DDS-Spy/network/members\"\u003e\u003cimg alt=\"Forks\" src=\"https://img.shields.io/github/forks/eProsima/Fast-DDS-Spy.svg\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/eProsima/Fast-DDS-Spy/stargazers\"\u003e\u003cimg alt=\"Stars\" src=\"https://img.shields.io/github/stars/eProsima/Fast-DDS-Spy.svg\"/\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://fast-dds-spy.readthedocs.io\"\u003e\u003cimg alt=\"Documentation badge\" src=\"https://img.shields.io/readthedocs/fast-dds-spy.svg\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/eProsima/Fast-DDS-spy/actions/workflows/nightly-windows-ci.yml\"\u003e\u003cimg alt=\"Windows CI\" src=\"https://img.shields.io/github/actions/workflow/status/eProsima/Fast-DDS-spy/nightly-windows-ci.yml?label=Windows%20CI\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/eProsima/Fast-DDS-spy/actions/workflows/nightly-ubuntu-ci.yml\"\u003e\u003cimg alt=\"Ubuntu CI\" src=\"https://img.shields.io/github/actions/workflow/status/eProsima/Fast-DDS-spy/nightly-ubuntu-ci.yml?label=Ubuntu%20CI\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\n*eProsima Fast DDS Spy* is a CLI interactive tool that allows to introspect a DDS network in human readable format.\nIt is possible to query the network about the DomainParticipants connected, their endpoints (DataWriters and DataReaders) and the topics they communicate in.\nIt is also possible to see the user data sent through network topics in a schematic format in run time.\n\n## Commercial support\n\nLooking for commercial support? Write us to info@eprosima.com\n\nFind more about us at [eProsima’s webpage](https://eprosima.com/).\n\n## Documentation\n\nYou can access the documentation online hosted on *Read the Docs*.\n\n* [Introduction](https://fast-dds-spy.readthedocs.io/en/latest/rst/formalia/titlepage.html)\n* [Installation Manual](https://fast-dds-spy.readthedocs.io/en/latest/rst/installation/linux.html)\n* [User Manual](https://fast-dds-spy.readthedocs.io/en/latest/rst/user_manual/usage_example.html)\n* [Developer Manual](https://fast-dds-spy.readthedocs.io/en/latest/rst/developer_manual/installation/sources/linux.html)\n* [Release Notes](https://fast-dds-spy.readthedocs.io/en/latest/rst/notes/notes.html)\n\n\n## Installation Guide\n\nThe instructions for installing the *Fast DDS Spy* application from sources and its required dependencies on a Linux\nenvironment are provided below. These installation instructions are a summarized version of the complete\n[installation guide](https://fast-dds-spy.readthedocs.io/en/latest/rst/developer_manual/installation/sources/linux.html) available online. Instructions for installing *Fast DDS Spy* on a **Windows** platform can be found\n[here](https://fast-dds-spy.readthedocs.io/en/latest/rst/developer_manual/installation/sources/windows.html).\n\n### Requirements\n\n*eProsima Fast DDS Spy* requires the following tools to be installed in the system:\n* [CMake](https://cmake.org/), [g++](https://gcc.gnu.org/), [pip](https://pypi.org/project/pip/), [wget](https://www.gnu.org/software/wget/) and [git](https://git-scm.com/)\n* [Colcon](https://colcon.readthedocs.io/en/released/) [optional, not required for CMake-only installation]\n\n```bash\n# apt packages\nsudo apt install -y \\\n    cmake \\\n    g++ \\\n    pip \\\n    wget \\\n    git \\\n    libasio-dev \\\n    libtinyxml2-dev \\\n    libssl-dev \\\n    libyaml-cpp-dev\n\n# python packages\npip3 install -U \\\n    colcon-common-extensions \\\n    vcstool\n```\n\n### Colcon installation\n\n1. Create a `Fast-DDS-spy` directory and download the `.repos` file that will be used to install *Fast DDS Spy* and its dependencies:\n\n    ```bash\n    mkdir -p ~/Fast-DDS-spy/src\n    cd ~/Fast-DDS-spy\n    wget https://raw.githubusercontent.com/eProsima/Fast-DDS-spy/main/fastddsspy.repos\n    vcs import src \u003c fastddsspy.repos\n    ```\n\n2. Build the packages:\n\n    ```bash\n    colcon build --packages-up-to fastddsspy_tool\n    ```\n\n### Run an application\n\nTo run the *Fast DDS Spy* application, source the installation environment and execute the executable file that has been\ninstalled in `\u003cinstall-path\u003e/fastddsspy_tool/bin/fastddsspy`:\n\n```bash\n# Source installation\nsource \u003cinstall-path\u003e/setup.bash\n\n# Execute Fast DDS Spy\nfastddsspy_tool\n# Use \u003cfastddsspy_tool --help\u003e to see the tool manual\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feprosima%2Ffast-dds-spy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feprosima%2Ffast-dds-spy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feprosima%2Ffast-dds-spy/lists"}