NAME
tumblr -- publish to tumblr.comSYNOPSIS
tumblr [OPTIONS] FILE OR URLDESCRIPTION
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 WunschTumblr is Copyright (c) Tumblr, Inc. The Tumblr gem is NOT affiliated with Tumblr, Inc.SEE ALSO
tumblr(5), gem(1)
tumblr -- publish to tumblr.comtumblr [OPTIONS] FILE OR URLtumblr is a command line utility and Ruby library for working with Tumblr.com. It can read plain-text files and publish them to Tumblr.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).tumblr more explicit instructions for publishing your post. See tumblr(5) for available YAML parameters.-a,--auth EMAIL:PASSWORDProvide 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 EMAILEmail Address associated with your Tumblr account. You will be prompted for a password.
--credentials FILEA YAML file with the user credentials. Should have keys
emailand password.-p,--publishPublish the post immediately. This will ignore the
stateparameter set in the post.-q,--queueAdd the post to the queue.
-d,--draftSave the post as a draft.
--group=GROUPPublish the post to a GROUP tumblelog.
-h, --helpPrint the help message and quit.
-v, --versionPrint the
tumblr version and quit.$ tumblr my_post.txt
$ cat data.yml my_post.txt | tumblr -a tumblr_user@foobar.com:p4ssw0rd
$ tumblr http://github.com/mwunsch/tumblr
$ tumblr http://www.youtube.com/watch?v=CW0DUg63lqU
$ tumblr -d http://www.youtube.com/watch?v=CW0DUg63lqU
$ cat ~/.tumblrlogin
email: tumblruser@generic-email.com
password: myvoiceismypassport
$ cat data.yml my_post.txt | tumblr --credentials ~/.tumblrlogin
gem install tumblr-rb
