Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Just another way for you to feed your Tumblr addiction.

Project Description

# Tumblr_Terminal

Creative name, huh? Tumblr_Terminal lets you blog your frustrations from the comfort of your terminal. Check out the examples below.

## Installation

I developed this with Python 2.7.6. If you are having trouble running it on your machine with Python 3.4+ or another version of Python, hit me up and we’ll try to debug.

First, make sure you have a Tumblr account. This may or may not be a wise choice, depending on your levels of self-control.

Once you have one, you need to get login credentials. Namely, your Consumer API Key, and Consumer Secret Key.

Go to to register an application. The only information that you absolutely need to provide are the ‘Application name’ and ‘Administrative contact email’. These values can be whatever you want them to be, as the main purpose is just to retrieve the keys. A ‘default callback URL’ is needed to register, though. If you have plans for developing a web application that utilizes the API to integrate Tumblr into, for example, your personal website so that people can post about how cool you are, then you can set this to your domain name. But if you do not care, you can either set it to ‘/’ (without the apostrophes, of course), or ‘http:’, where the latter option allows you to develop on your local machine.

Now that you have your Consumer and Consumer Secret keys, install Tumblr_Terminal by running: pip install tumblr_terminal If everything went smoothly, when you start up your terminal and type tumblr, you should be prompted to enter your Consumer and Secret Keys, after which you will be told to follow a link.

Go through the link, and you will be asked to allow the application to access your information. Allow it, then copy the redirect URL and paste it into the terminal as instructed.

After following the instructions, restart your terminal and type tumblr or tumblr --usage. If all went well, you should not be met with an infuriating traceback for some error or another. Awesome!

## Features

As of version 0.1, one can only make text posts. More features, including but not limited to posting pictures, quotes, audio and aspects such as draft and queue management are coming soon-ish.

## Examples

To make a text post without a title: ` $ tumblr -t "My post" `

For a text post with a title: ` $ tumblr -tt "My post" `

To make a text post with tags: ` $ tumblr -t "My post" --tags "tag1, tag2, tag3..." `

Now, you can specify whether your post is published, saved as a draft, or put on your queue:

To publish a text post: -t or -pt To save a text post as a draft: -dt And, to queue a text post: -qt

Use tumblr --usage for a reference to some of the commands. ## Credit

The module is a modified version of the file in Tumblr’s official Python client, found [here]( Please read their [LICENSE]( for more information regarding distribution and usage.

## Contact

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tumblr_terminal-0.3.tar.gz (4.5 kB) Copy SHA256 Checksum SHA256 Source Jun 24, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting