mersal

Send SMS and Otp in nim, a wrapper for TextBelt's public API

Wrapper score 15/100 · tests present · no docs generated

Wraps a native library — check OS Compatibility below for platform-specific linking notes.

Summary

Latest Version Unknown
License MIT
CI Status Failing
Downloads 0
Last Indexed 2026-07-21 05:25

Tags

otp wrapper sms

Installation

nimble install mersal
choosenim install mersal
git clone https://github.com/foxoman/mersal

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
mersal ✓ ✓ ✓ - - - - - - -

Source

Repository https://github.com/foxoman/mersal
Homepage https://github.com/foxoman/mersal
Registry Source nimble_official

README

Mersal

     _   __ ___  ___    ___   _   __
  / \,' // _/ / o | ,' _/ .' \ / /
 / \,' // _/ /  ,' _\ `. / o // /_
/_/ /_//___//_/`_\/___,'/_n_//___/
                 Built by FOXOMAN

Send SMS and Otp in nim, a wrapper for TextBelt's (http://textbelt.com) public API Sultan Al Isaee ~ foxoman @2022 See MIT LICENSE.txt for details of the license.

Mersal is an SMS/OTP API Wrapper for textbelt (http://textbelt.com) public API, that is built for developers who just want to send and receive SMS in nim.

So what does it provide:

  • Send sms to any international mobile number using the standard number way +CCMobile
  • Track the delivery of any sms sent
  • Send Otp to any mobile number same like sending message
  • Make your own message content instead of default Your verification code is $OTP
  • verify the otp
  • check your credit balance

Is it free ?

Texetbelt provide you with free key textbelt to be able to send one free message a day, but you can purchase an sms package from here - https://textbelt.com/purchase/?generateKey=1 , you will need to use a key with credit.

Install mersal

To install mersal for your nim development package:

nimble install mersal

then import mersal and enjoy using it is api in your app.

image.png

Bellow an example of a full app to send a message:

import termui, terminal
import mersal

const logo = """

   _   __ ___  ___    ___   _   __
  / \,' // _/ / o | ,' _/ .' \ / /
 / \,' // _/ /  ,' _\ `. / o // /_
/_/ /_//___//_/`_\/___,'/_n_//___/
                 Built by FOXOMAN
                            v 1.0
"""

const help = """
[*] Use E.164 mobile numbers format:

    Example: +447712345678:

    Prefix      Country code      Subscriber number
    +           44 (UK)           7712345678
"""

styledEcho(fgCyan, logo, resetStyle)
styledEcho(fgYellow, help, resetStyle)
styledEcho(fgRed, """[*] Use at your own risk!
[*] 'textbelt' is free key for one message a day only.
""", resetStyle)

let mobile = termuiAsk("What is the mobile you want to send the message to?",
    defaultValue = "+447712345678")
let message = termuiAsk("What is your message?",
    defaultValue = "Hello World")
let key = termuiAsk("What is your API Key?",
    defaultValue = "textbelt")

let sendingMsg = termuiSpinner("Prepare to send the message...")

sendingMsg.update("Sending the message...")

let (ok, id, credit, error) = sendSms(mobile, message, key)

sendingMsg.update("Getting the resposnse....")

if not ok:
  sendingMsg.fail(error & "\n")

else:
  sendingMsg.complete("TextId: " & id &
      " | quotaRemaining: " & $credit & "\n")

discard getch()

Reference

  • Mersal Github repo: https://github.com/foxoman/mersal
  • Buy a credit: https://textbelt.com/create-key/
  • Read Mersal Api: https://mersal-doc.surge.sh/mersal
  • Read textbelt FAQ: https://docs.textbelt.com/