{"id":15163354,"url":"https://github.com/snappey/mqtt-explorer","last_synced_at":"2025-10-29T09:30:26.509Z","repository":{"id":178158278,"uuid":"661427662","full_name":"Snappey/MQTT-Explorer","owner":"Snappey","description":"CLI based tool for monitoring and exploring MQTT brokers, inspired by the original MQTT Explorer","archived":false,"fork":false,"pushed_at":"2024-01-16T19:50:22.000Z","size":1820,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-21T22:24:39.145Z","etag":null,"topics":["bubbletea","cli","golang","mqtt","mqtt-client","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Snappey.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":"2023-07-02T20:07:46.000Z","updated_at":"2024-11-07T12:38:43.000Z","dependencies_parsed_at":"2024-01-16T22:17:10.705Z","dependency_job_id":"ca041870-b4de-488c-a999-0bd773fbc1b0","html_url":"https://github.com/Snappey/MQTT-Explorer","commit_stats":null,"previous_names":["snappey/mqtt-explorer"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snappey%2FMQTT-Explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snappey%2FMQTT-Explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snappey%2FMQTT-Explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snappey%2FMQTT-Explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Snappey","download_url":"https://codeload.github.com/Snappey/MQTT-Explorer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238798699,"owners_count":19532277,"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","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":["bubbletea","cli","golang","mqtt","mqtt-client","tui"],"created_at":"2024-09-27T02:40:17.786Z","updated_at":"2025-10-29T09:30:26.033Z","avatar_url":"https://github.com/Snappey.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"./assets/logo.png\" width=\"200\" title=\"Login With Custom URL\"\u003e\n\u003c/p\u003e\n\u003ch3 align=\"center\"\u003eMQTT Explorer - CLI based MQTT client displayed in an easy to navigate tree\u003c/h3\u003e\n\u003cdiv align=\"center\"\u003e\n\n[![Build](https://github.com/Snappey/MQTT-Explorer/actions/workflows/go.yml/badge.svg)](https://github.com/Snappey/MQTT-Explorer/actions/workflows/go.yml)\n[![Release](https://github.com/Snappey/MQTT-Explorer/actions/workflows/release.yml/badge.svg)](https://github.com/Snappey/MQTT-Explorer/actions/workflows/release.yml)\n\n\u003c/div\u003e\n\u003ch5 align=\"center\"\u003e The project is currently in early development, bugs and weirdness to be expected.\u003c/h5\u003e\n\u003cbr/\u003e\n\u003ca href=\"https://immich.app\"\u003e\n\u003cimg src=\"./assets/demo.gif\" title=\"Main Screenshot\"\u003e\n\u003c/a\u003e\n\u003cbr/\u003e\n\n\nA CLI for exploring and interacting with MQTT topics, inspired by the original [MQTT-Explorer](https://mqtt-explorer.com), but brought directly into your command line. This tool enables you to navigate and view your MQTT broker's topic structure in a intuitive, tree-like format, and provides functionality to view the latest payload data and publish arbitrary messages to existing topics.\n\n## Features\n\n**Current:**\n- Visualize your entire broker's topic structure in an interactive, navigable tree.\n- View the latest and historical payloads for any given topic.\n- Publish arbitrary messages to existing topics.\n- Copy payloads to clipboard for easy sharing.\n- Fullscreen mode for larger payloads.\n\n**Planned:**\n- Publish to arbitrary topics with customizable QoS and Retained message configurations.\n- Implement search functionality and filtering capabilities for the topic structure.\n- Syntax highlighting for payloads to improve readability.\n- Profile support to automatically connect to saved brokers\n\n## Installation\n\nMQTT-Explorer can be installed using `go install` or downloading the latest binary from Releases.\n\n```shell\ngo install github.com/snappey/mqtt-explorer@latest\n```\n\n## Usage\n\nEnsure that the binary exists within your PATH, this is handled for you if `go install` is used.\n\n```shell\nmqtt-explorer [flags]\n\nFlags:\n  -h, --help              help for mqtt-explorer\n      --hostname string   hostname of the broker (default \"test.mosquitto.org\")\n      --port int          port the broker is running on, typically tcp: 1883, ssl: 8883, ws: 8083 or wss: 8084 (default 1883)\n      --scheme string     protocol to use tcp, ssl, ws or wss (default \"tcp\")\n      --topic string      topic to subscribe to on the broker (default \"#\")\n```\n### Keybinds\n```shell\nQ, Ctrl+C                     - Close the application\nArrow Keys                    - Move around the Tree / Select Payloads\nShift Up/Down Arrow Keys      - Skip 5\nShift Ctrl Up/Down Arrow Keys - Skip 25\nHOME                          - Skip to Start\nEND                           - Skip to End\nTAB                           - Cycle focus between each Panel\nC                             - Copy the selected payload to clipboard\nV                             - Paste the selected payload into publish message textarea\nF                             - Toggle fullscreen mode (only available when selecting a payload)\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnappey%2Fmqtt-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnappey%2Fmqtt-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnappey%2Fmqtt-explorer/lists"}