Todo.txt

What's the todo.sh Jabber bot?

The todo.sh Jabber bot, written by mailing list member Shiva KM, executes todo.sh commands on your todo.txt via Jabber-based instant messages. Run it on the computer where your todo.txt lives.

Especially useful for IM'ing todo's from your phone, the todo Jabber bot reads and writes your todo.txt from anywhere (without having to run a home server.)

Google Talk uses Jabber and will store chat transcripts with your bot in Gmail's "Chats" folder.

See also: How to connect to the Yahoo! transport through the TODO bot.

Download the todo.sh Jabber bot

Download the latest version of the todo.sh Jabber bot. (now hosted at Google Code.)

Requirements:

• Python
• 2 Jabber screennames
• xmpppy

Installation

1. First register for a Jabber screenname which you'll use as your bot.
2. Get Python running on the computer where your todo.txt lives. If you're running Cygwin, install the Python package using setup.exe, as described here. Mac and Linux users, you're all set with Python.
3. Download the Todo Jabber Bot files.
4. Unzip the Todo Jabber bot archive. Then, open up the file called todo_jbot.py and edit the following lines:
   

   SCREENNAME = 'yourbotnick@jabber.org'	# Your bot's Jabber ID 
   PASSWORD   = 'yourbotpassword'		# Your bot Jabber pasword
   COMMANDER  = 'commanderNick@jabber.org'	# Your Jabber ID
   TODOSCRIPT = '/home/shiva/bin/todo.sh -p -f'	# Path to your todo script
   GTALK_SERVER = 'talk.google.com'        # google talk server - you shouldn't need to change this
   
   

   
   In the first two lines, enter the bot nickname and password you signed up for in step 1. In the third line, enter the Jabber name you'll use to run todo commands. In the last line, enter the full path to your todo manager script, plus options. Most Jabber clients support HTML so your linebreakchar variable can most likely stay as is. Save and close todo_jbot.py.
5. To start the TodoBot, at the command line type python todo_jbot.py.

Finally, IM your bot's nick using your regular Jabber name a todo.sh command, except omit the todo.sh bit. So todo.sh add do laundry would be simply add do laundry.

Author

Unless otherwise noted, all the todo.txt scripts published herein are authored by Gina Trapani and licensed under the GNU General Public License.

Scripts and text originally published as an ongoing Todo.txt series at Lifehacker.com. Special thanks to all the Lifehacker readers who contributed to Todo.sh by fixing code, adding features, reporting bugs and making suggestions.

All software comes as is with no warranty. Do back up your todo.txt before you read another word. Questions, support and help is available in the Todo.txt Mailing list.