Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP unofficial API
branch: master

This branch is 20 commits behind badboy:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

TeuxDeux (unofficial API)

This library acts as a client for the unofficial TeuxDeux API.

With it you can do all the things the webinterface can do:

  • fetch your todos
  • create new todos
  • update your todos
  • delete your todos

See the API documentation for more information about the returnend data.


Create new client

client = :login => "mail", :password => "secret"

Get user data

=> <#Hashie::Rash email="mail" id=42 login="name" time_zone="Berlin" utc_offset=60>

Get todos

=> [<#Hashie::Rash do_on="2011-05-26" done=false id=10601581 position=0 todo="create awesome teuxdeux client" updated_at=1306353624 user_id=42>, ...]

Get "someday" todos

=> [<#Hashie::Rash do_on="1989-12-01" done=false id=10601582 position=0 todo="be awesome" updated_at=1298486839 user_id=42>, ...]

Create todo item

client.create_todo("get freaky!", "2011-06-01")
=> [<#Hashie::Rash do_on="2011-06-01" done=false id=10601583 position=0 todo="get freaky!" updated_at=1306360182 user_id=42>, ...]

Update todo item

client.update_todo({ 10601581 => { :done => true } })
=> [<#Hashie::Rash do_on="2011-05-26" done=true id=10601581 position=0 todo="create awesome teuxdeux client" updated_at=1306360182 user_id=42>, ...]

Delete todo item

=> true


This TeuxDeux API client was developed as an reference implementation of the unofficial TeuxDeux API.

The API documentation was possible thanks to mislav's instagram docu and his post about how he did the reasearch.

The code is heavily inspired by the awesome Octokit, a ruby wrapper for the GitHub API.


If there are bugs or missing features, please let me know. I would like to accept pull-requests.

As this is just the API client, what we now need is some alternative interfaces. I definitely need a solution for my Android phone. I'm not sure if I should stick with a web app or if I should create a native app.

If you want to help with either of this or just have additional questions or another implementation, contact me.

Something went wrong with that request. Please try again.