README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

Usage: blasms sender-number send-date

SMS content should be passed using stdin.

blasms.conf is the configuration file and should be in the format:
  default SYSTEM COMMANDS
  CMD1 SYSTEM COMMANDS
  CMD2 SYSTEM COMMANDS
  etc.

Where SYSTEM COMMANDS can be any command to be executed.  The line starting
with 'default' must be present, and is the default command in the absense of a
recognised command.  CMD1, CMD2, etc. are commands which can be matched at the
start of SMSes, in order to execute commands other than the default.  Macros
are available, allowing for text replacement.  The macros available are:
  %N - replaced with the sender-number, and attempts to set a sender name (see
       below)
  %n - replaced with the sender-number
  %d - replaced with the send-date
  %s - replaced with the SMS content
  %P - attempts to replace the second word in the SMS with a destination number\n"
       from phonebook.conf - SMS not processed if entry not found\n"

An example blasms.conf might be:
  default echo \"SMS from %N at %d: %s\"
  LS ls %s

Sender names are looked up in phonebook.conf, which should be in the format:
  NUMBER1 NAME1 NAME1-ALT
  NUMBER2 NAME2
  etc.

An example phonebook.conf might be:
  +447777123456 John
  +447713987654 Bill

With a default gnokii (at least with gnokii-0.6.29) apostrophes (') will be
escaped.  Removing this behaviour is desirble to blasms and does not cause
any adverse effects (so far).  A patch for gnokii to remove the escaping
behaviour is in gnokii/.