# OpenModScan
**Repository Path**: huyuxiang/OpenModScan
## Basic Information
- **Project Name**: OpenModScan
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-20
- **Last Updated**: 2026-02-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# OpenModScan
[](https://github.com/sanny32/OpenModScan/releases)
[](https://github.com/sanny32/OpenModScan/releases/latest)
[](LICENSE.md)
OpenModScan is a free and open-source Modbus Master (Client) utility supporting both Modbus-TCP and Modbus-RTU protocols.
## Features
The following Modbus functions are available:
Discrete Coils/Flags
0x01 - Read Coils
0x02 - Read Discrete Inputs
0x05 - Write Single Coil
0x0F - Write Multiple Coils
Registers
0x03 - Read Holding Registers
0x04 - Read Input Registers
0x06 - Write Single Register
0x10 - Write Multiple Registers
0x16 - Mask Write Register
## Modbus Logging
## Extended Featues
- Modbus Address Scan
- Modbus Scanner (support protocols: Modbus RTU, Modbus TCP and Modbus RTU over TCP)
- Modbus Message Parser
- Modbus User Message
# Building
Building is available via cmake (with installed Qt version 5.15 and above) or Qt Creator. Supports both OS Microsoft Windows and Linux.
## Microsoft Windows Building
The minimum supported version of Microsoft Windows for building OpenModScan from sources is Windows 10.
1. Install latest [git](https://git-scm.com/downloads/win) version
2. Run Windows PowerShell terminal as an Administrator
3. Clone OpenModScan sources from github repository
```powershell
git clone https://github.com/sanny32/OpenModScan.git
```
4. Go to OpenModScan folder
```powershell
cd OpenModScan
```
5. Allow script execution in PowerShell terminal
```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
```
6. Run the build script
```powershell
.\build.ps1
```
If you need to specify Qt framework major version (5 or 6), you can do it in the parameters
- `.\build.ps1 -qt5` or `.\build.ps1 -qt6`
The build script supports building the application only for 64-bit architecture.
## Linux Building
1. Install [git](https://git-scm.com/downloads/linux) for your Linux distribution
2. Run the following commands from the console:
```bash
git clone https://github.com/sanny32/OpenModScan.git
```
```bash
cd OpenModScan
```
```bash
./build.sh
```
If you need to specify Qt framework major version (5 or 6), you can do it in the parameters
- `./build.sh -qt5` or `./build.sh -qt6`
# About supported operating systems
The following minimum operating system versions are supported for OpenModScan:
- 
**Microsoft Windows 7**
- 
**Debian Linux 11**
- 
**Ubuntu Linux 22.04**
- 
**Mint Linux 22**
- 
**Zorin OS 18**
- 
**Fedora Linux 41**
- 
**Rocky Linux 9.7**
- 
**OpenSuse Linux 15.6**
- 
**Alt Linux 11**
- 
**Astra Linux 1.7**
- 
**RedOS 8**
# Install from [binary distributions](https://github.com/sanny32/OpenModScan/releases/latest)
Below are the methods for installing the OpenModScan for different OS
## 
Microsoft Windows
Run the installer:
- For 32-bit Windows: `qt5-omodscan_1.13.1_x86.exe`
- For 64-bit Windows: `qt5-omodscan_1.13.1_x64.exe` or `qt6-omodscan_1.13.1_x64.exe`
## Debian / Ubuntu / Mint / Zorin / Astra Linux
### Install
Install the DEB package from the command line:
```bash
sudo apt install ./qt6-omodscan_1.13.1-1_amd64.deb
```
or if you want to use Qt5 libraries:
```bash
sudo apt install ./qt5-omodscan_1.13.1-1_amd64.deb
```
### Remove
To remove the DEB package run:
```bash
sudo apt remove qt6-omodscan
```
or for Qt5 package:
```bash
sudo apt remove qt5-omodscan
```
## 
RedHat / Fedora / Rocky / RedOS Linux
### Install
Install the RPM package from the command line:
```bash
sudo dnf install ./qt6-omodscan_1.13.1-1.x86_64.rpm
```
### Remove
To remove the RPM package run:
```bash
sudo dnf remove qt6-omodscan
```
## Alt Linux
### Install
Install the RPM package from the command line as root user:
```bash
apt-get install ./qt6-omodscan_1.13.1-1.x86_64.rpm
```
### Remove
To remove the RPM package run as root user:
```bash
apt-get remove qt6-omodscan
```
## 
SUSE / OpenSUSE Linux
### Install
Import qt6-omodscan.rpm.pubkey to rpm repository:
```bash
sudo rpm --import qt6-omodscan.rpm.pubkey
```
Install the RPM package using Zypper:
```bash
sudo zypper install ./qt6-omodscan_1.13.1-1.x86_64.rpm
```
### Remove
To remove the RPM package run:
```bash
sudo zypper remove qt6-omodscan
```
## 
Flatpak
### Install
Install flatpak package run the followning commands:
```bash
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
```
```bash
flatpak install --user io.github.sanny32.omodscan.flatpak
```
If you want to use a serial port connection, you must add the user to the `dialout` group
```bash
sudo usermod -a -G dialout $USER
```
and then log in to the user again or reboot the computer.
### Remove
To remove the flatpak package run:
```bash
flatpak uninstall --user io.github.sanny32.omodscan
```
# Code Signing Sponsor
Windows binaries for this project are signed thanks to **SignPath Foundation**.
* 🔐 **Free code signing service:** [SignPath.io](https://signpath.io)
* 📜 **Certificate provider:** [SignPath Foundation](https://signpath.org)
# MIT License
Copyright 2023-2026 Alexandr Ananev [mail@ananev.org]
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.