Readme for nikepub-1.0

nikepub INTRODUCTION nikepub is a simple commandline program that given a Nike+ user id will fetch the most recent Nike+ run and publish it to any blog and/or Twitter account. Assumes the Nike+ user profile is public. Supports customizable templates for the blog entry title, body and Twitter status update. Any blogging system with XML-RPC support for metaWeblog.newPost (like WordPress or MovableType) is supported. A description of the implementation can be found in this series of blog posts: http://www.codemanic.com/uwe/2009/05/publishing-nike-runs-part-1-numeric-lists.html http://www.codemanic.com/uwe/2009/06/publishing-nike-runs-part-2-google-charts.html http://www.codemanic.com/uwe/2009/06/publishing-nike-runs-part-3-handling-xml.html http://www.codemanic.com/uwe/2009/06/publishing-nike-runs-part-4-string-templates.html http://www.codemanic.com/uwe/2009/06/publishing-nike-runs-part-5-blogging-and-twitter.html INSTALLATION nikepub comes as a cabal package so doing $ runhaskell Setup configure --prefix=$HOME --user $ runhaskell Setup build $ runhaskell Setup install in the untarred package directory will install nikepub in $HOME/bin. USAGE Example command line flags (fill in values where you see <value description>s): nikepub --id=<your nike+ id> \ --templates=<path to a templates dir> \ --mtUrl=<url to your blog xml-rpc> \ --mtUser=<your blog username> \ --mtPassword=<path to a file containing your blog api password> \ --message=<any additional message you want in blog entry> \ --twitterUser=<your twitter username> \ --twitterPassword=<path to a file containing your twitter password> The distribution package contains an example template directory. It can be used directly or customized. The example template files have all the supported $fields$ in them. All three files must be present in a template directory. You might want to copy the template directory into a more convenient place. Your Nike+ profile is assumed to be public. nikepub doesn't work with non-public profiles (if you publish your runs with nikepub you might as well have your profile public). Your Nike+ id is an integer. The simplest way to find it out is to share a run or your profile in the Flash UI on the Nike+ website by choosing to grab the link to the run you want to share in the Share menu. The pasteboard now has a URL with your Nike+ user id in the URL params. The --message flag on the nikepub commandline lets you append an arbitrary message to the body of the generated blog entry. BUGS, SUGGESTIONS, COMMENTS Please send to uwe@codemanic.com