menuimage

Description

Usage

Example

Options

Conffile_example

Datafile_example

Exit_Codes

Dependencies

License

Changelog

Download

Donation

My_Other_Sites

My_Programs

Comments

sms-sender v1.9 [02 May 2018] by Dominic

Description

Send SMS text message using Dellmont's Voicetrading. You must already have an account at https://www.voicetrading.com, with some credit on it.

Account settings (variables USERNAME, PASSWORD, COUNTRYCODE [default '44'], LOGFILE [default '/var/log/.log'] and SAVEDIR [default '/root']) are obtained from conffile [default 'sms-sender.conf' in same directory as sms-sender.sh].

Mobile numbers can start with '+' or '00' or, if in the COUNTRYCODE country, a single '0'. Multiple send numbers can be separated by commas or semicolons or forward slashes, if quotes are used then spaces are ignored and the numbers can be enclosed with < > to allow a save file to have more meaningful text.

If a subject is specified, then a successfully-sent text is saved as eml file in $SAVEDIR. The subject is *not* sent as part of the text.

Usage

sms-sender.sh [options] from_num to_num text

Example

./sms-sender.sh 0712345678 0723456789 "hello mum it's me!"

Options

-c conffile specify path/file for conffile
-d debug mode
-f datafile obtain info from datafile (blank line *must* precede text)
-h to see this help text and exit
-l see changelog and exit
-n show number of characters in message only, then exit
-s subject specify subject and save successful message at $SAVEDIR
-t test mode (don't send text)
-v verbose (text output)

Conffile example

# USERNAME and PASSWORD are obligatory
USERNAME=myusername
PASSWORD=12345678
# COUNTRYCODE: for numbers not starting with 00 or +
COUNTRYCODE=44
LOGFILE=/home/me/sms-sender.sh.log
SAVEDIR=/home/me/sms

Datafile example

To: James Smith <07765 432101>, Jenny Smith <07765 433101>
From: Phil Burton <07831 123456>
Subject: Reminder

Please remember to visit us soon! Thank you.

Exit Codes

0 - message sent successfully
1 - error reported by VoiceTrading.com, message could not be sent
2 - error identified by sms-sender.sh, message could not be sent

Dependencies

bash coreutils curl sed curl dellmont-credit-checker.sh(from:https://www.timedicer.co.uk/programs/help/dellmont-credit-checker.sh.php)

License

Copyright © 2021 Dominic Raferd. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Changelog


1.9 [02 May 2018]: bugfix - ensure $TMPFILE exists even if curl fails
1.8 [06 Oct 2017]: allow $SAVEDIR to be specified in conf file
1.7 [03 Dec 2015]: correct the cookiejar file to use same as other scripts
1.6 [02 Sep 2015]: with -s option, save file with lowercase of subject name
1.5 [26 Aug 2014]: add -n option
1.4 [19 Dec 2013]: minor bugfixes
1.3 [18 Dec 2013]: complete rewrite, requires dellmont-credit-checker.sh
1.2 [14 Mar 2012]: use conffile, first public release
1.1101 : trivial changes
1.0922 : first version

Download sms-sender.sh

Donation

I have provided this software free gratis and for nothing. If you would like to thank me with a contribution, please let me know and I will send you a link. Thank you!

My Other Sites

My Programs

Here is a selection of some (other) programs I have written, most of which run from the command line (CLI), are freely available and can be obtained by clicking on the links. Dependencies are shown and while in most cases written for a conventional Linux server, they should run on a Raspberry Pi, and many can run under Windows using Windows Subsystem for Linux (WSL) or Cygwin. Email me if you have problems or questions, or if you think I could help with a programming requirement.

Backup Utilities

Debian/Ubuntu kernel and LVM Utilities

Dellmont - VoIP and Mobile Phone Account Utilities

Miscellaneous Programs

Comments

If you have a comment or question, please email me, thank you.

No comments yet for '/programs/help/sms-sender.sh.php'