# Tumblr-0.0.1 - tumblr for the command line

**URL:** <https://www.ruby-forum.com/t/tumblr-0-0-1-tumblr-for-the-command-line/119086>\
**Category:** Ruby\
**Created:** [November 2, 2007, 11:42pm UTC](https://www.ruby-forum.com/t/tumblr-0-0-1-tumblr-for-the-command-line/119086 "2007-11-02T23:42:35Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![ara.t.howard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/a/a8b319/32.png) [@ara.t.howard](https://www.ruby-forum.com/u/ara.t.howard)\
**Post date:** [November 2, 2007, 11:42pm UTC](https://www.ruby-forum.com/t/tumblr-0-0-1-tumblr-for-the-command-line/119086/1 "2007-11-02T23:42:35Z")

</div>

(email issues - sorry if double post)

NAME  
tumblr

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

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

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

=== install ===

```
 gem install tumblr

```

=== cli ===

```
 the cli exactly mirrors the library api. arguments are passed

```

to each  
method as ‘key=val’ pairs, values may be read from files using the  
syntax ‘key=file=val’ or ‘key==val’

```
 you should first cache your login info to avoid having to pass

```

it everytime

```
   cfp: ~> tumblr setup --email=my_email --password=my_password --

```

name=drawohara  
/Users/ahoward/.tumblr.yml

```
 you can post

   cfp: ~> tumblr write regular title=testing body=rock_on

 you can post from files

   cfp: ~> tumblr write regular title=slurp body==./post.html

 you can read

   cfp: ~> tumblr read start=42 num=42

 you can test the auth

   cfp: ~> tumblr authenticate

 etc.

```

=== api ===

```
 it's pretty simple. here's a start, use the web docs to figure

```

out the  
rest

```
   config = {
     :email => my_email,
     :password => my_password,
     :name => 'drawohara'
   }

   tumblr = Tumblr.for config

   abort unless tumblr.uri == 'http://drawohara.tumblr.com'

   response = tumblr.write :regular, :title = title, :body => body

   video = open 'video.mpg'
   response = tumblr.write :video, :data => video, :title =>

```

video.path

```
   response = tumblr.read :start => 42, :num => 42
   xml = response.content

   response = tumblr.read :start => 42, :num => 42, :json => true
   json = response.content

```

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

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