# \[ANN\] tumblr-0.0.1 - tumblr for the command line

**URL:** <https://rubytalk.org/t/ann-tumblr-0-0-1-tumblr-for-the-command-line/41879>\
**Category:** ruby-talk\
**Created:** [2 November 2007 22:32 UTC](https://rubytalk.org/t/ann-tumblr-0-0-1-tumblr-for-the-command-line/41879 "2007-11-02T22:32:19Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![a11](https://yyz1.discourse-cdn.com/flex029/user_avatar/rubytalk.org/a11/32/8169_2.png) [@a11](https://rubytalk.org/u/a11)\
**Post date:** [2 November 2007 22:32 UTC](https://rubytalk.org/t/ann-tumblr-0-0-1-tumblr-for-the-command-line/41879/1 "2007-11-02T22:32:19Z")

</div>

(email issues - sorry if double post)

NAME  
&nbsp;&nbsp;&nbsp;tumblr

SYNOPSIS  
&nbsp;&nbsp;&nbsp;tumblr (setup|write|read|authenticate|check-vimeo|check-audio) [options]+

DESCRIPTION  
&nbsp;&nbsp;&nbsp;tumblr.rb is a command line utility and library which interfaces to the  
&nbsp;&nbsp;&nbsp;excellent tumblr blogging platform @ [http://www.tumblr.com](http://www.tumblr.com)

&nbsp;&nbsp;&nbsp;tumblr.rb implements the complete restful api in both library and  
&nbsp;&nbsp;&nbsp;command line utility, doccumented in full @ [http://www.tumblr.com/api](http://www.tumblr.com/api)

&nbsp;&nbsp;&nbsp;=== install ===

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;gem install tumblr

&nbsp;&nbsp;&nbsp;=== cli ===

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;the cli exactly mirrors the library api. arguments are passed to each  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;method as 'key=val' pairs, values may be read from files using the  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;syntax 'key=file=val' or 'key==val'

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;you should first cache your login info to avoid having to pass it everytime

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cfp: ~\> tumblr setup --email=my\_email --password=my\_password --name=drawohara  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/Users/ahoward/.tumblr.yml

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;you can post

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cfp: ~\> tumblr write regular title=testing body=rock\_on

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;you can post from files

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cfp: ~\> tumblr write regular title=slurp body==./post.html

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;you can read

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cfp: ~\> tumblr read start=42 num=42

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;you can test the auth

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cfp: ~\> tumblr authenticate

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;etc.

&nbsp;&nbsp;&nbsp;=== api ===

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;it's pretty simple. here's a start, use the web docs to figure out the  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rest

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;config = {  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:email =\> my\_email,  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:password =\> my\_password,  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:name =\> 'drawohara'  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tumblr = Tumblr.for config

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;abort unless tumblr.uri == '[http://drawohara.tumblr.com](http://drawohara.tumblr.com)'

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;response = tumblr.write :regular, :title = title, :body =\> body

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;video = open 'video.mpg'  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;response = tumblr.write :video, :data =\> video, :title =\> video.path

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;response = tumblr.read :start =\> 42, :num =\> 42  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;xml = response.content

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;response = tumblr.read :start =\> 42, :num =\> 42, :json =\> true  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;json = response.content

PARAMETERS  
&nbsp;&nbsp;&nbsp;--name=name, -n (1 ~\> name)  
&nbsp;&nbsp;&nbsp;--email=email, -e (1 ~\> email)  
&nbsp;&nbsp;&nbsp;--password=password, -p (1 ~\> password)  
&nbsp;&nbsp;&nbsp;--debug, -d  
&nbsp;&nbsp;&nbsp;--json, -j  
&nbsp;&nbsp;&nbsp;--help, -h

a @ [http://codeforpeople.com/](http://codeforpeople.com/)

> **···**
>
> --  
> share your knowledge. it's a way to achieve immortality.  
> h.h. the 14th dalai lama
