Skip to content
This repository

A Tumblr mode for Emacs

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 README.markdown
Octocat-spinner-32 tumble.el

Not working anymore...

This mode was written to work with Tumblr's API v1. This package won't work with the newest, oAuth-only API. In the meantime you might want to use Tumblesocks.

Tumble - An Emacs mode for Tumblr


Tumble is a mode for interacting with Tumblr inside Emacs. It currently supports the following types of posts:

  • Text
  • Quote
  • Link
  • Chat
  • Photo
  • Audio
  • Video (only through embed)

You can start tumbling by using the following functions:








Posts can either be published or saved as drafts, you'll be prompted when you upload them. If you leave the 'State' field empty the post will be published.

Read tumble.el for more information about each function.


Download Tumble to some directory:

$ git clone git://

Add it to your load list and require it:

(add-to-list 'load-path "~/some_directory/tumble")
(require 'tumble)

At this point you can, either set your Tubmblr account info on your .emacs file:

tumble-email:    your account e-mail
tumble-password: your account password
tumble-url:      your account url (the main blog url)

Or just post without setting them, Tumble will prompt you for your account details when you try to make a post.

If you want to post to a group or secondary blog, you should instead set the tumble-group variable.

You can also customize the format of the post by modifying the tumble-format variable. Tumble uses Markdown as default for posting.

Tumble uses HTTP when posting. This is certainly less secure than using HTTPS, but it's faster and the Tumblr API behaves in a weird way with HTTPS. If you want to use HTTPS you can change the tumble-api-url variable. It's by default, just change the http part to https.


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Check tumble.el for more information.

Fork freely!


Something went wrong with that request. Please try again.