tumblesocks-mode - Tumblr Support for Emacs
Tumblesocks is an Emacs tumblr client. With it, you can write posts, check your dashboard, and view blogs and notes.
The main entry point is
tumblesocks-view-dashboard, which will
open up a list of posts from your dashboard.
Use these keys to jump around:
- n and p: Move quickly to the next and previous posts
- q: Quit; go back to what you were doing before.
Visiting each post:
l: Like the post underneath the cursor. Use
C-u lto unlike it.
f: Follow whichever blog wrote the post underneath the cursor. Use
C-u fto unfollow the blog.
- o: Open the post underneath the cursor in your web browser.
- y: Yank the URL of the post underneath the cursor to the kill ring/clipboard.
- s: Search for posts with a certain tag.
- b: Visit Blog: Show a list of posts from a certain blog.
- Enter: Open the post underneath the cursor in a new page, showing its notes.
- g: Refresh the current view (download new posts)
Managing your posts:
- r: Reblog the post under the cursor. This function will prompt you for extra comments to add.
c: Compose new post. Once you are finished writing your post, use
C-c C-cto submit it. Markdown syntax is supported.
- d: Delete the post under the cursor. (This only works if you made that post.)
- e: Edit the post under the cursor. (This only works if you made that post.)
If you have Emacs 24, you can install Tumblesocks from Marmalade the
easy way by inserting the following into your
(setq package-archives '(("gnu" . "http://elpa.gnu.org/packages/") ("marmalade" . "http://marmalade-repo.org/packages/")))
M-x package-install tumblesocks, kick back, and skip to
the next section.
If you instead want to add Tumblesocks to your Emacs manually, you must have these dependencies:
- Emacs 24
- The Emacs OAuth library
htmlize.el, which is available here.
markdown-mode, available here.
json.el, which is part of Emacs 24.
Add all of that to your
load-path, and make sure
'tumblesocks) doesn't complain.
If you're on Windows, you may need extra libraries; see this ticket for details. In short:
- You'll need a build of Emacs that includes
libxmlsupport; Dani Moncayo's emacs-bin includes this and other libraries.
- You may also need the Windows build of libxml in the same folder as your emacs.exe binary.
- Tip number 4 on this blog post will allow you to see images inline in Emacs generally, and in Tumblesocks.
If you're on Linux, you shouldn't have these problems.
How to connect Tumblesocks to your tumblr account
The first time you use Tumblesocks, you mist connect Emacs to your tumblr account. This process is a bit convoluted, but you only have to do it once.
First, add the following to your .emacs:
(require 'tumblesocks) (setq tumblesocks-blog "YourBlogName.tumblr.com")
Apply the changes, either by running
M-x eval-buffer or by
M-x tumblesocks-api-test-auth to connect Emacs to your
Tumblr will open a webpage asking for access. Once you click Accept, you will receive a very long code. Copy+paste that back into your Emacs prompt (you can also use middle-click to do this).
If everything goes right, you will see a message like this in your minibuffer:
Hello, sneakygcr! Tumblesocks is working properly.
If anything goes wrong (typically "401 Not Authorized" errors), you
can ask Tumblesocks to forget your key by issuing
M-x tumblesocks-api-forget-authentication. Then use
M-x tumblesocks-api-test-auth again to reconnect your Emacs to your
If it won't authorize in the first place and just says "Looks like
something broke." it might be the OAuth package wasn't configured.
Try to see if the variable
oauth-nonce-function is set, if not add
(setq oauth-nonce-function 'oauth-internal-make-nonce) to your
Other "advanced" commands
If you have gumption, try these out:
tumblesocks-text-post-from-region: Instantly create a post with the contents of region.
tumblesocks-text-post-from-buffer: Instantly create a post from the entire buffer
tumblesocks-compose-new-from-region: Open a buffer and start writing a new post. The contents of region will be copied over.
tumblesocks-compose-new-from-highlighted-region: Open a buffer and start writing a new post. The contents of region will be syntax-highlighted and copied into the post as formatted HTML. This is super-useful for including source code into your tumbles.
tumblesocks-compose-insert-highlighted-region: Insert the syntax-highlighted region at the end of post you're currently writing.