THIS PROJECT IS DEPRECATED.  Unfortunately, zipwhip turned their software into
mostly garbage.  This is one of the (many) problems with relying too heavily
on closed and proprietary software and infrastructure.

I'm currently using pushbullet to replicate this funcionality, but I don't 
love it.  When I have some time, I would love to build something integrated
with owncloud or some other self hosted solution that is free (as in speech
AND beer).

zipwhip_cli
===========

NEW GUI VERSION!  zwcli will still work as a command line only client, but 
if you would like a full fledged linux GUI please check out install with
screenshots here:

http://trustdarkness.com/wordpress/zipwhip-for-linux-new-gui-version/

This is a command line interface to the ZipWhip cloud texting service.

A short backstory:  I hate typing on my phone.  Thus, when Google Voice
came out, I was happy to have an alternative to text via my computer.
Later, I became a privacy nut and pulled my data out of Google's services
but I found I really missed the functionality of Google Voice for texting.

ZipWhip doesn't have all of that functionality, but it has some of it, and
though there is no privacy inherint in ZipWhip's service, I don't need 
to lock into a whole ecosystem to use it like I do Google Voice. 

Though I give kudos to ZipWhip for making a linux client, they 
unfortunately made it only for Ubuntu and did not release the source.
I used the web interface on Fedora for some time, but grew tired of having
to use up an extra tab just for that.  Thankfully, the folks at ZipWhip
have a great API.

So, I threw together this very basic command line interface.  It currently
has ZERO bells and whistles.  It will allow you to view the last message
in every conversation in your texting "inbox" and it will allow you to send
text messages via a phone number.

Usage is pretty simple:

    $ zwcli -h
    usage: zwcli.py [-h] [-c] [-r READ] [-s] [-t TO] [-m MSG] [-u USER]
                [-p PASSWORD] [-R] [-g]

    optional arguments:
      -h, --help            show this help message and exit
      -c, --cron            Run in 'cron' mode, or non-interactively... meant for
                            cron jobs or watch processes. Defaults to 'read' mode,
                            reading recent texts to standard out. Can be combined
                            with -s for send or -r for read,
      -r READ, --read READ  Read the last X text messages to std out. Can be run
                            like ./zwcli.py -r20 to read only the last 20
                            messages, defaults to 10
      -s, --send            Run in send mode. Must be combined with -t and -m (but
                            may be also be combined with -u and -p to specify a
                            user and password, for use with cron, etc.
      -t TO, --to TO        Number to send a message to, must be combined with -s
                            and -t Currently must be a phone number, a named
                            contacts will not work.
      -m MSG, --msg MSG     Message to send. Must be combined with -s and -t.
                            Length is limited by either zipwhip or your carrier.
                            Nothing is guaranteed. enclose your message in quotes
                            for best results, like: ./zwcli.py -s -t5555555555
                            -m'LOL ROFLMAOBBQ!!!'
      -u USER, --user USER  Username / Phonenumber to send from. Currently must be
                            a 10 digit phone number that is already setup on
                            zipwhip in the form 5555555555. If you don't supply a
                            username, we will try to use a previously saved one or
                            prompt you on the console.
      -p PASSWORD, --password PASSWORD
                            Password for zipwhip account to send from. Beware bash
                            history! If you don't supply a password, we will try
                            to use a previously saved one or prompt you on the
                            console.
      -R, --markread        Mark all messages as read. Must be used with -r.
      -g, --gui             Display gui notifications


Examples:
=========

    $ ./zwcli.py
    Enter zipwhip number: 3125555555
    Enter password: 
    Would you like to save this info? 
    THIS IS NOT SECURE and will allow anyone with access to this
    account on your computer the ability to send and recieve 
    messages via your ZipWhip account
    Save? y/n y
    Select one of the following options:
        1. See recent conversations
        2. Send a text
 
    selection: 1
    New? |      Time: |     Conv With: | Last Msg:
         |      09:14 |     651XXXXXXX |  cds are in the mail... will try to call
         |            |                |  you from the airport tonight
         |            |                |
      *  |      09:13 |            456 |  Free T-Mobile Msg: $69.59 has been added
         |            |                |  to your account. Your new balance is
         |            |                |  $70.00. Thanks for refilling!
         |            |                |
         |      09:06 |     8009378997 |  -=call=- Outgoing Phone Call Duration:
         |            |                |  276 seconds
         |            |                |
         |      09:04 |     8009378997 |  -=call=- Outgoing Phone Call Duration: 99
         |            |                |  seconds
         |            |                |
         |      08:23 |            456 |  Free T-Mobile Msg: Your payment for your
         |            |                |  T-Mobile plan is past due so your plan is
         |            |                |  inactive. Visit my.t-mobile.com/billing
         |            |                |  to make a payment to get your
         |            |                |
      <more> 



+++ snip +++

    $ ./zwcli.py
    You've successfully logged in.
    Select one of the following options:
        1. See recent conversations
        2. Send a text
 
    selection: 2
    Phone Number to Text: 773XXXXXXX
    Message to send: I hate white rabbits!
 
    Getting ready to send
 
         I hate white rabbits!
 
      to: 773XXXXXXX
    Confirm? y/n y
    Message sent successfully!
    
+++ snip +++

    $ zwcli -c
    
    You've successfully logged in.
    New? |      Time: |     Conv With: | Last Msg:
         |      09:14 |     651XXXXXXX |  cds are in the mail... will try to call
         |            |                |  you from the airport tonight
         |            |                |
      *  |      09:13 |            456 |  Free T-Mobile Msg: $69.59 has been added
         |            |                |  to your account. Your new balance is
         |            |                |  $70.00. Thanks for refilling!
         |            |                |
         |      09:06 |     8009378997 |  -=call=- Outgoing Phone Call Duration:
         |            |                |  276 seconds
         |            |                |
         |      09:04 |     8009378997 |  -=call=- Outgoing Phone Call Duration: 99
         |            |                |  seconds
         |            |                |
         |      08:23 |            456 |  Free T-Mobile Msg: Your payment for your
         |            |                |  T-Mobile plan is past due so your plan is
         |            |                |  inactive. Visit my.t-mobile.com/billing
         |            |                |  to make a payment to get your
         |            |                |



TODOS:
======

Optionally interface with other backends?  I'd like to move to using ubuntu 
touch on my phone full time instead of Android, but replicating this 
functionality is pretty important to me.  With that in mind...

- Add multiple backends
-- Zipwhip + Android
-- Google Voice + Android (maybe)?
-- Owncloud + Ubuntu Touch (would require writing an ubuntu touch app and an
owncloud texting app... but if I have time to do that):
-- Owncloud + Android
-- Owncloud + Firefox OS

If you've stumbled across this and use it, please let me know!