tumble

A Tumblr Mode for Emacs

Overview
Installing
Using
Acknowledgments
License

Overview

Tumble is an Emacs mode to upload your posts to Tumblr. It supports these posts:

Text
Quote
Link
Chat
Photo
Audio
Video

Note: Video uploads are only available through embed links. I've never used Vimeo uploads so it's not currently supported. I can help you writing a patch for this, just contact me at federico.builes@gmail.com.

Installing

ELPA

Tumble is included in Emacs ELPA. You can install it by doing:

          M-x package-install        ;; the package is named "tumble"

Alternatively, you can browse all the packages and select it from the list:

          M-x package-list

Regular Installation

Download the compressed file and extract it to your preferred directory.

You can also clone it from Github:

          $ git clone git://github.com/febuiles/tumble.git

This should create a 'tumble' directory. Add it to your load list and require it:

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

Open tumble.el and modify the following variables:

          (setq tumble-email "your_email@something.com")
          (setq tumble-password "your_password")
          (setq tumble-url "your_tumblelog.tumblr.com")

(optional) Tumble uses no group for posting and it uses Markdown as the default format but you can change these:

          (setq tumble-group "your_group.tumblr.com")
          (setq tumble-format "html")

Using

Tumble provides the following functions to upload your posts:

Texts

tumble-text-from-region
Uploads the current selected region as a new text post.

tumble-text-from-buffer
Uploads the current buffer as a new text post.

Note: Remember that Tumble defaults the composition mode to "Markdown" so watch out for formatting

Quotes

tumble-quote-from-region
Uploads the current region as a new quote post.

Links

tumble-link
Creates a new link post with an optional title.

tumble-link-with-description
Uses the region to create the description for a new link post. Title is optional.

Chats

tumble-chat-from-region
Uploads the current region as a new chat post.

tumble-chat-from-buffer
Uploads the current buffer contents as a new chat post.

Photos

tumble-photo-from-url
Creates a new photo post using the source URL as the image to display.

tumble-photo-from-file
Creates a new photo post using a local file as the image to display.

Songs

tumble-audio
Uploads a song and creates a new audio post.

Note: Remember that Tumblr has a limit for daily audio uploads.

Videos

tumble-video-from-url
Uses the video from the source given to create a new video post.

Acknowledgements

Tumble is inspired by Tumbl, created by Carl Groner.

Tumble uses the http-post-simple library, written by Tom Schutzer-Weissmann.

License

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.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.