packages feed

nikepub-1.0: README

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