{"id":13649525,"url":"https://github.com/dheera/rosshow","last_synced_at":"2025-10-05T01:00:10.377Z","repository":{"id":43113775,"uuid":"90426514","full_name":"dheera/rosshow","owner":"dheera","description":"Visualize ROS topics inside a terminal with Unicode/ASCII art","archived":false,"fork":false,"pushed_at":"2024-06-21T05:22:00.000Z","size":3028,"stargazers_count":1095,"open_issues_count":6,"forks_count":91,"subscribers_count":22,"default_branch":"main","last_synced_at":"2025-05-23T06:09:48.136Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dheera.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}},"created_at":"2017-05-06T00:24:02.000Z","updated_at":"2025-05-10T13:58:01.000Z","dependencies_parsed_at":"2024-06-21T22:49:10.469Z","dependency_job_id":"35afb1f4-68a7-4c5b-bb98-9d5ee37e1af6","html_url":"https://github.com/dheera/rosshow","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dheera/rosshow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dheera%2Frosshow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dheera%2Frosshow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dheera%2Frosshow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dheera%2Frosshow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dheera","download_url":"https://codeload.github.com/dheera/rosshow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dheera%2Frosshow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278395910,"owners_count":25979690,"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-10-04T02:00:05.491Z","response_time":63,"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":[],"created_at":"2024-08-02T02:00:18.127Z","updated_at":"2025-10-05T01:00:10.349Z","avatar_url":"https://github.com/dheera.png","language":"Python","funding_links":[],"categories":["Visualization","User Interaction","Interaction","ROS"],"sub_categories":["Extracting data","Command Line Interface","Command Line","Libraries and Packages"],"readme":"# rosshow: Visualize ROS topics in a terminal\n\nHave you ever SSH'ed into a robot to debug whether sensors are outputting\nwhat they should, e.g. ```rostopic echo /camera/image_raw```?\n\nIf so, rosshow is for you.\n\nThis displays various sensor messages in a useful fashion using Unicode Braille art in the terminal so you don't need to fire up port forwards, rviz, or any other shenanigans just to see if something is working. It currently only supports types from std_msgs and sensor_msgs but support for more types is coming. Contributions welcome!\n\n# Installation\n\nPrerequisites:\n\n```\nsudo pip install numpy pillow requests\n```\n\nThis package works with both ROS1 and ROS2. You can add it to either a catkin (ROS1) or colcon (ROS2) workspace and it should work.\n\n# Usage\n\nIf you installed it to the system:\n```\nrosshow \u003ctopicname\u003e\n```\n\nIf you're using it from a catkin or colcon workspace:\n```\nrosrun rosshow rosshow \u003ctopicname\u003e      # ROS1\nros2 run rosshow rosshow \u003ctopicname\u003e    # ROS2\n```\n\nMost visualizations use Unicode Braille characters to render visualizations. If your terminal supports only ASCII, you can use the `-a` option for a purely ASCII-art render:\n```\nrosshow -a \u003ctopicname\u003e\n```\nYou can also force 1-bit, 4-bit, or 24-bit color modes if your terminal type is not detected correctly. You may need these when using rosshow inside of a `screen`.\n```\nrosshow -c1 \u003ctopicname\u003e\nrosshow -c4 \u003ctopicname\u003e\nrosshow -c24 \u003ctopicname\u003e\n```\n\n# Screenshots\n\n## sensor_msgs/PointCloud2\n\nYou can rotate and tilt with the arrow keys, and zoom with the +/- keys.\nThis has been tested with Velodyne data. PointClouds from devices that don't have \"x\", \"y\", and \"z\" fields are not supported.\n\n![screenshot](/screenshots/screenshot5.png?raw=true \"screenshot\")\n\n## sensor_msgs/Image, sensor_msgs/CompressedImage\n\n![screenshot](/screenshots/screenshot4.png?raw=true \"screenshot\")\n\n## sensor_msgs/LaserScan\n\nYou can zoom with the +/- keys.\n\n![screenshot](/screenshots/screenshot0.png?raw=true \"screenshot\")\n\n## sensor_msgs/Imu\n\n![screenshot](/screenshots/screenshot2.png?raw=true \"screenshot\")\n\n## sensor_msgs/NavSatFix\n\nThe NavSatFix visualization fetches map tiles from OpenStreetMaps, so your machine or robot needs to have internet access to be able to view those. Otherwise, you'll still be able to see a trace of points.\n\n![screenshot](/screenshots/screenshot3.png?raw=true \"screenshot\")\n\nThe ASCII-only \"-a\" option works for all types. Here's what the NavSatFix message looks like on pure ASCII:\n\n![screenshot](/screenshots/screenshot3-ascii.png?raw=true \"screenshot\")\n\n## std_msgs/Int32, std_msgs/Float32, etc.\n\nFor most std_msgs numeric types you will get a time series plot.\n\n![screenshot](/screenshots/screenshot6.png?raw=true \"screenshot\")\n\nNeat trick: You can reduce your terminal font size to get slightly higher resolution. Here's a nav\\_msgs/OccupancyGrid:\n![screenshot](/screenshots/screenshot7.png?raw=true \"screenshot\")\n\n# Full list of supported types\n\n### nav_msgs\n* nav_msgs/OccupancyGrid\n* nav_msgs/Odometry\n* nav_msgs/Path\n\n### std_msgs\n* std_msgs/Bool\n* std_msgs/Float32\n* std_msgs/Float64\n* std_msgs/Int8\n* std_msgs/Int16\n* std_msgs/Int32\n* std_msgs/Int64\n* std_msgs/UInt8\n* std_msgs/UInt16\n* std_msgs/UInt32\n* std_msgs/UInt64\n\n### sensor_msgs\n* sensor_msgs/CompressedImage\n* sensor_msgs/FluidPressure\n* sensor_msgs/Illuminance\n* sensor_msgs/Image\n* sensor_msgs/Imu\n* sensor_msgs/LaserScan\n* sensor_msgs/NavSatFix\n* sensor_msgs/PointCloud2\n* sensor_msgs/Range\n* sensor_msgs/RelativeHumidity\n* sensor_msgs/Temperature\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdheera%2Frosshow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdheera%2Frosshow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdheera%2Frosshow/lists"}