twerp 0.0.2

Twilio command-line application for sending SMS text messages and making voice calls.

README
======

.. contents::


Installation
------------

pip install twerp



Configure twerp
---------------

~/.twerprc


ACCOUNT_SID=a902830980980980ff987yada

AUTH_TOKEN=98798asdfas9df87sadf987yada

CALLERID=[phone]



Usage Examples
==============

$ twerp -N

List your Twilio phone numbers


$ twerp -Nv

List lots of details about each of your Twilio numbers:


$ twerp -m 'this is a test' -s [phone]

Send SMS message to [phone]

$ twerp -c [phone] -u http://computer.net/TWIML

Call [phone] and execute the TWIML at given URL

$ twerp -c [phone],[phone] -u http://twimlets.com/conference?Music=rock

Call two numbers and put them in a conference room. First one gets rock music till another caller joins.


$ twerp -l

List all of your SMS messages (Be careful if you have zillions, filtering coming soon)


$ twerp -S nnnnnnnnnnnn

Show details of SMS message by SID


$ twerp -i --dial [phone] -u http://twimlets.com/conference?Music=rock
Go into interactive command-line mode after calling number.


Interactive Mode
================


The Prompt
----------

The prompt will have part of the SID if a call is in progress:

twerp (CA3...ab) >>

If you hang up a call, for example, there will be no SID, so the prompt will look like this:

twerp (...) >>


Interactive Mode Commands
-------------------------

list - List all calls in progress, ringing or queued
hangup - Hang up call associated with SID shown in prompt
nuke - Hang up all calls associated with account. ALL OF THEM!
forward - Forward call to another phone number
url - Redirect flow of call to TwiML at a URL
info - Show info for current SID or SID given
sid - Change the current SID associated with interactive-mode


TODO
----

See http://blog.cakebread.info/



.. Twerp News

News
====

0.0.3
-----

*Release date: 1/17/2012

* Added --interactive command-line feture to control calls in progress
* Changed many keyword options, we're still super++ pre-alpha, so I can do that.
* Added docs at http://twerp.rtfd.org/


0.0.2
-----

*Release date: 1/6/2012

* Added voice dialing

0.0.1
-----

*Release date: 1/5/2012

* Initial release