sms.git

1) # SMS
2) This is a simple bash script that allows you to send sms-textmessages using the the HTTP-API of ```sms-revolution.ch```
3) 
4) It supports a simple contact-list, and entering your message using vim.
5) 
6) ## Recipient
7) When prompted ```To:``` you can either enter a number, corresponding to a entry in the contact-list (which will be printed), or enter a phone number (starting with ```0``` or ```+``` ). 
8) The number will be posted to ```httpsms.php``` and phrased there. (aka. you can use any format, both when prompted and in the contact-list, that their backend can pharse)
9) 
10) Please note that ```contacts``` needs to be in the format of ```^name,phonenumber$```, one entry per line. (see ```contacts_example```)
11) 
12) ## Message body
13) When prompted ```Message: ``` you can either enter your message directly or enter one of the following to get to the corresponding prompt/editor;
14) * ```cat``` cat  (crtl-d to finish editing)
15) * ```sed``` sed  (empty line to finish editing)
16) * ```vim``` vim  (close editor to finish editing) (ps. preserves message if it is or can not be sent)
17) 

18) Before sending the message you are prompted whether it should be sent. (```n``` will set ``action=info``; the request will be sent, however ```httpsms.php``` will only return information (how it interpreted your input and whether the message could be sent) but not send the message.)