smsender is a lightweight, production-ready command-line utility for sending SMS messages via SMSAPI (smsapi.pl).

It is designed to be used as a standalone executable in scripts, automation workflows, monitoring systems, and industrial environments such as SCADA systems.

Repository:
https://github.com/piotrmalek/smsender

• Send SMS messages directly from the command line
• Support for multiple recipients (-p can be used multiple times)
• Free-form SMS content (-m) with full support for - characters
• Secure API token storage using Windows DPAPI:
  • CurrentUser scope
  • LocalMachine scope
• Clear, color-coded console output
• Automatic color disabling when output is redirected
• Masking of sensitive data (API token)
• Consistent exit codes for scripting and automation
• Minimal client-side validation (final validation is handled by SMSAPI)

• Windows (Windows DPAPI is used)
• .NET runtime (matching project configuration)
• SMSAPI account
• Active SMSAPI OAuth token

1. Clone the repository:

   git clone https://github.com/piotrmalek/smsender.git

2. Build the project:

   dotnet build -c Release

3. Copy smsender.exe to a desired location (e.g. tools or automation directory)

smsender -t YOUR_API_TOKEN

smsender -tm YOUR_API_TOKEN

Notes:

• Tokens are encrypted using Windows DPAPI
• token.dat:
  • cannot be decrypted on another machine
  • cannot be decrypted by another user (for CurrentUser scope)

smsender -s Alarm -p 48111111111 -m Device failure detected

smsender -s SCADA -p 48111111111 -p 48222222222 -m Critical fault - production stopped

smsender -s Monitor -p 48111111111 -m Voltage drop -10% on phase L2

smsender integrates seamlessly with Cimon SCADA, allowing SMS alarm notifications to be sent directly from scripts or object actions.

Sub SendSMS()
    RunApp "D:\smsender.exe", "-s Monitor -p 48111111111 -m Pump P3.2 overheated"
End Sub

Typical use cases:

• alarm handling scripts
• scheduled checks
• conditional notifications

smsender can also be triggered from an object action.

Command Expression example:

RunApp("D:\smsender.exe", "-s Alarm -p 48111111111 -m Emergency stop activated")

Typical use cases:

• operator-triggered alarms
• service notifications
• maintenance actions

For SCADA and HMI environments, the GUI (no-console) build is recommended:

• GUI (no-console) build: smsender-win-x64-gui.zip

Advantages:

• no command-line window popup
• silent background execution
• better operator experience

The CLI build remains useful for:

• diagnostics
• scripting
• command-line testing

These exit codes are suitable for:

• Batch scripts
• PowerShell
• Monitoring systems
• SCADA environments

• API tokens are never printed in full
• Tokens are encrypted locally using DPAPI
• No plaintext credentials stored
• No environment variables required

• SCADA alarm and fault notifications
• Server and service monitoring
• Scheduled automation tasks
• Industrial maintenance systems
• Manual SMS sending from CLI

This project is licensed under the MIT License.

Distributed as-is, without any warranty.

Piotr Małek
GitHub: https://github.com/piotrmalek