# mqttclient_python

**Repository Path**: chenxi2000/mqttclient_python

## Basic Information

- **Project Name**: mqttclient_python
- **Description**: 用python开发的mqtt客户端
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-25
- **Last Updated**: 2026-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python MQTT Client

这是一个基于 Python 的图形界面 MQTT 客户端应用程序，使用了 `tkinter` 和 `ttkbootstrap` 构建现代化的用户界面，并使用 `paho-mqtt` 库处理 MQTT 通信。

## 功能特点

*   **现代化界面**：使用 `ttkbootstrap` 的 "darkly" 主题，提供舒适的暗色模式体验。
*   **连接管理**：
    *   支持配置 Broker URL (默认: `tcp://broker.emqx.io:1883`)。
    *   自动生成随机 Client ID，也支持自定义。
    *   支持用户名和密码认证。
    *   一键连接和断开。
*   **消息订阅**：
    *   支持订阅指定主题。
    *   支持取消订阅。
*   **消息发布**：
    *   向指定主题发布消息。
    *   支持 QoS 1。
*   **实时日志**：
    *   实时显示连接状态、发送的消息和接收到的消息。
    *   带时间戳的日志记录。

## 安装依赖

在运行程序之前，请确保已安装 Python 环境，并安装所需的第三方库：

```bash
pip install -r requirements.txt
```

或者手动安装：

```bash
pip install paho-mqtt ttkbootstrap
```

## 运行程序

直接运行 Python 脚本即可启动应用程序：

```bash
python mqtt_app.py
```

## 使用说明

1.  **启动程序**：运行脚本后，窗口将显示在屏幕中央。
2.  **配置连接**：
    *   在 "Broker URL" 输入 MQTT Broker 的地址 (例如 `tcp://broker.emqx.io:1883`)。
    *   如果需要，输入用户名和密码。
    *   点击 "Connect" 按钮连接到 Broker。
3.  **订阅主题**：
    *   连接成功后，在下方的 "Subscribe" 区域输入要订阅的主题 (例如 `test/topic`)。
    *   点击 "Subscribe" 按钮。
4.  **发布消息**：
    *   在 "Publish" 区域输入目标主题和消息内容。
    *   点击 "Publish" 按钮发送消息。
5.  **查看日志**：
    *   所有的操作和接收到的消息都会显示在中间的 "Logs & Messages" 区域。

## 依赖库

*   [paho-mqtt](https://pypi.org/project/paho-mqtt/): Eclipse Paho MQTT Python client library.
*   [ttkbootstrap](https://pypi.org/project/ttkbootstrap/): A supercharged theme extension for tkinter.