Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
67 lines (39 sloc) 2.39 KB


Command line interface and Ruby client for the Tumblr API

It's being rewritten from the ground up to support v2 of the api.

Check out tag v1.3.0 if you are interested in v1. The master branch is now dedicated to v2, and is not in steady state.

Like the previous version, the current version reads files with a special front-matter block, like Jekyll. In addition, this new version offers the ability to post photos, videos, and audio.

Unlike the previous version, this new command line utility uses OAuth to authenticate and authorize the user.


  • Documentation, documentation, documentation
  • Given a URL, determine if its a link, a video, or an audio post
  • Man pages
  • tumblr edit and tumblr delete actions
  • Task to build a homebrew formula


Until the gem is published, you'll just need to clone this repository. Run bundle install and bundle exec bin/tumblr.


Run tumblr authorize to boot up a small application to manage the fancy OAuth handshake with tumblr. You'll be prompted for a consumer key and secret you get from registering an app.

Getting Started

Like Jekyll, and Mustache, Tumblr gem will transform documents preceded by a YAML frontmatter block.

YAML frontmatter beings with --- on a single line, followed by YAML, ending with another --- on a single line, e.g.

type: quote
source: Billy Shakespeare
state: draft
tags: hamlet, shakespeare
"To be or not to be."

Understood YAML parameters are taken from the Tumblr API:

All Posts

type                text, photo, link, quote, chat, video, audio
                    will take a guess if ommitted.

state               published, queue, draft, private

format              html or markdown

tags                comma-separated list of tags

date                post date

slug                A custom string to appear in the post's URL

tweet               Manages the autotweet (if enabled) for this post


The Tumblr gem is Copyright (c) 2010 - 2012 Mark Wunsch and is licensed under the MIT License.

Tumblr is Copyright (c) Tumblr, Inc. The Tumblr gem is NOT affiliated with Tumblr, Inc.

Something went wrong with that request. Please try again.