Permalink
Browse files

add README

  • Loading branch information...
1 parent 5a82efc commit 2249343901205e34af381f48ff025aeb1dff8dfa @titanous titanous committed May 4, 2010
Showing with 83 additions and 0 deletions.
  1. +22 −0 LICENSE
  2. +61 −0 README.md
View
@@ -0,0 +1,22 @@
+Copyright (c) 2010 Jonathan Rudenberg
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
View
@@ -0,0 +1,61 @@
+# Tropo Voicemail
+
+This app is designed to replace your GSM phone's voicemail. Instead of a
+phone-based voicemail inbox, messages are transcribed and emailed with a link
+to the audio file.
+
+Please note that I only spent a few hours writing this, so there may be bugs,
+and it's just a starting point that could be developed a lot further.
+
+## Requirements
+
+* [Heroku](http://heroku.com) account
+* [Tropo](http://www.tropo.com) account
+* FTP server with HTTP access
+* GSM phone with call forwarding
+
+## Setup
+
+### Heroku
+
+ git clone git@github.com:titanous/tropo-voicemail.git
+ cd tropo-voicemail
+ heroku create
+ heroku addons:add sendgrid:free
+ heroku config:add EMAIL=you@email.com
+ heroku config:add VOICEMAIL_URL=http://yourserver.com/voicemail/
+ git push heroku master
+
+### Tropo
+
+Create a new application on Tropo, and point it to a new Hosted File with the
+contents of `tropo-voicemail.rb`. Make sure you change the constants at the top
+of the file to be real values. The FTP URL may not match the HTTP URL given
+above (you may need a `public_html`).
+
+You now have two options. If you are in the US, then you can add a free USA
+Domestic number. Note that you probably want a number in your local calling
+area. If you aren't in the US or couldn't find a local number on Tropo, then you
+should get a SIP DID from a company like [Voip.ms](http://voip.ms/) and forward
+it to the Tropo SIP URI.
+
+### Cell Phone
+
+The last step is to use some GSM feature codes to setup conditional call
+forwarding. Dial each of these numbers on your cell phone and press Send:
+
+ *67*TROPO_PHONE_NUMBER# (forward if busy)
+ *61*TROPO_PHONE_NUMBER# (forward if not answered)
+ *62*TROPO_PHONE_NUMBER# (forward if out of reach)
+
+The phone should show a message after each that says something about the
+conditional call foward being set. If for any reason you need to disable these
+forwards, use these codes:
+
+ ##67#
+ ##61#
+ ##62#
+
+## Copyright
+
+(c) 2010 Jonathan Rudenberg; Licensed under the MIT license, see `LICENSE`

0 comments on commit 2249343

Please sign in to comment.