Friday 16 December 2011


NAME

tumblr -- publish to tumblr.com

SYNOPSIS

tumblr [OPTIONSFILE OR URL

DESCRIPTION

tumblr is a command line utility and Ruby library for working with Tumblr.com. It can read plain-text files and publish them to Tumblr.
The tumblr command will publish a named input FILE (or Standard Input if no file is given), or if a URL is given it will publish that URL as a Link post (or a Video post if the url is a YouTube or Vimeo post).
If you preface your FILE with a bit of YAML (<yaml.org>) frontmatter, you can give tumblr more explicit instructions for publishing your post. See tumblr(5) for available YAML parameters.

OPTIONS

-a,--auth EMAIL:PASSWORD
Provide Email Address and Password, to authenticate to Tumblr, separated by a colon. If these are not provided, you will be prompted for them. You must provide this or the --credentialsargument if the post comes from standard input.
-e--email EMAIL
Email Address associated with your Tumblr account. You will be prompted for a password.
--credentials FILE
A YAML file with the user credentials. Should have keys emailand password.
-p,--publish
Publish the post immediately. This will ignore the stateparameter set in the post.
-q,--queue
Add the post to the queue.
-d,--draft
Save the post as a draft.
--group=GROUP
Publish the post to a GROUP tumblelog.
Other:
-h--help
Print the help message and quit.
-v--version
Print the tumblr version and quit.

EXAMPLES

Publish a file to Tumblr.com:
$ tumblr my_post.txt
Or from standard input:
$ cat data.yml my_post.txt | tumblr -a tumblr_user@foobar.com:p4ssw0rd
Make a Link post:
$ tumblr http://github.com/mwunsch/tumblr
Or a Video post:
$ tumblr http://www.youtube.com/watch?v=CW0DUg63lqU
Save it as a draft:
$ tumblr -d http://www.youtube.com/watch?v=CW0DUg63lqU
Authenticate with credentials given from a file:
$ cat ~/.tumblrlogin
email: tumblruser@generic-email.com
password: myvoiceismypassport
$ cat data.yml my_post.txt | tumblr --credentials ~/.tumblrlogin

INSTALLATION

If you have RubyGems installed:
gem install tumblr-rb

COPYRIGHT

Tumblr (the gem) is Copyright (C) 2010 Mark Wunsch
Tumblr is Copyright (c) Tumblr, Inc. The Tumblr gem is NOT affiliated with Tumblr, Inc.

SEE ALSO

tumblr(5), gem(1)

No comments:

Post a Comment