DraftKing for Tumblr takes the hassle out of managing your draft queue!

• (New!) Batch Uploader: Upload a list of URLs/files
• Auto-Poster: Publish up to 200 posts a day!
• Save and name your own DK commands!
• Automate the addition of comments and tags.
• Strip away old comments.
• Easily replenish your queue.
• Randomize post order to add variety.
• Manage multiple accounts.

Version 0.10.0.1

• Fix for Faraday::ConnectionFailed when trying to reach Tumblr

• Please report any issues you encounter!

• Change Log

• Installation
• Setup
  • 1. Register an app
  • 2. Get oauth_token and oauth_token_secret
  • 3. Run setup
• Usage
  • Command Line Interface
    • Custom Commands
    • My Workflow
    • Examples
      • Configured Accounts
      • Blog list
      • Commenting
      • Drafts or Queue
      • Stripping Comments
      • Comment & Move
      • Auto-Poster
      • Batch Uploader
    • Testing Console
  • API
• Built With
• Test Suite
• Contributing

$ gem install tumblr_draftking

https://www.tumblr.com/oauth/apps

• Application Name: DraftKing
• Application Description: [anything]
• Administrative contact email: [your email address]
• Default callback URL: [any url]

Once registered you should see your Consumer Key and Secret Key:

Using your Consumer Key and Secret Key from above, access https://api.tumblr.com/console/calls/user/info

$ dk setup

Setup will walk you through saving your configuration for future use.

The CLI will walk you through connecting to your Tumblr account the first time it's run.

• See: Setup

Once you've got that configured, check the help to familiarize yourself with your options.

$ dk -h

You can store your DK commands in your configuration file's (i.e. ~/.dkconfig) user_commands array.

Configuration file with two custom commands: tag_with_cool & show_other_account_status

---
:config_name: utb
:api_keys:
  consumer_key: [your_consumer_key]
  consumer_secret: [your_consumer_secret]
  oauth_token: [your_oauth_token]
  oauth_token_secret: [your_oauth_token_secret]
:user_commands:
  tag_with_cool:
    command: dk tag -t cool -c cool
    description: Add the tag and comment 'cool' to posts
    config_name: utb
  show_other_account_status:
    command: dk status --config account2
    description: Show the status blogs under account2
    config_name: account2

Trigger custom command example:

$> dk tag_with_cool

I manually add comments for posts where I want more detail, using a separator ( / | , \ ) to identify tags.

• These tags/comment will not be removed by dk.

  ~MD~ | architecture | landscape | blue | yams |

Then I'll let DraftKing automatically comment and tag the rest, strip old comments, and move them to my queue.

$ dk md -c ~MD~

• It will preserve post comments which already contain the string passed via -c ~MD~, so I don't need to worry about overwriting my special cases.
• It will also generate tags from the comment. In the above case you would get: #architecture #landscape #blue #yams (the comment in not added as a tag)

And that's it, my queue is loaded with manicured posts!

By default dk will act on your primary blog. To target an secondary blog, specify it using -b <blog name>

$ dk accounts

#> * ---- Accounts ---- *
#>     0. (Default)
#>     1. ugly-test-blog
#>     2. nice-test-blog

The default account is the configuration used when calling dk.
If the default doesn't exists, the first available configuration will be used.

To use an alternate account: $dk accounts -s . A dialog will help you set it as the default.
To delete an account configuration: $dk accounts -d . A dialog will let you choose which one.

$ dk blogs
#> #-------- Blogs --------#
#> 1. 'primary-blog-name'
#> 2. 'second-blog-name'

• Add the comment "dude, where's my car?"
• Target primary blog
• Apply to Drafts
• Keep existing tags (-k)
• Keep existing comments (-K)

$ dk comment -c "dude, where's my car?" -k -K

#> Adding draft comment "dude, where's my car?": 32 / 32 [100%]

• Add the comment 'where's your car, dude?'
• Target primary blog
• Apply to Queue (--source q)
• Limit action to 42 posts (-l 42)
• Remove old comments

$ dk comment -c "where's your car, dude?" --source q -l 42

#> Adding queue comment "where's your car, dude?": 32 / 32 [100%]

• Remove old comments
• Apply to Drafts
• Target 'second-blog-name' (-b second-blog-name)
• Simulate (-s)

$ dk strip -b second-blog-name -s

#> Stripping previous comments: 113 / 113 [100%]

• Add the comment "draftking for tumblr"
• Target primary blog
• Apply to Drafts
• Generate tags from comment for posts with a comment already containing 'tumblr_draftking'
• Keep existing tags (-k)
• Add tags #new, #tags, #to, #add
• Remove old comments
• Move posts to the Queue.
• Suppress progress message (-m)

$ dk md -c "draftking for tumblr" -k -t new,tags,to,add -m

• Publish from the Drafts (-s)
• Add the comment "draftking auto poster" (-c)
• Target blog named 'test-blog' (-b)
• Keep existing tags (-k)
• Remove old comments (default behavior)
• Add tags #new, #tags, #to, #add (-t)

$ dk ap -b 'test-blog' -c 'draftking auto poster' -k -t 'new,tags,to,add' -s :drafts

• Provide input file (-f FILE_PATH)
• Upload to secondary blog (-b BLOG_NAME)
• Provide a url to visit when photo is clicked (-l LINK_URL)
• Add tags #blog2, #my upload (-t)
• Input file format example available via $ dk help ups

$ dk ups -f /Users/meis/Desktop/new_stuff.txt -b blog2 -l blog2.tumblr.com -t 'blog2, my upload,'

The dk console can act as a sandbox while you explore the api or you can use it to actively manage your account.
By default it runs in simulation mode so any changes you make will not affect your account.

$ dk console
irb:> $dk.status
irb:> $dk.strip_old_comments

# Switch to live mode
irb:> $dk.simulate = false

By default, API Keys are read from ~/*.dkconfig (See: Setup) or you can pass them at the time of Client creation.

require 'tumblr_draftking'

# Use default configuration file: ~/.dkconfig
dk = DK::Client.new()

# Specify your own configuration file
dk = DK::Client.new(config_file: file_path)

# Define directly
dk = DK::Client.new(keys: { consumer_key:       'your value',
                            consumer_secret:    'your value',
                            oauth_token:        'your value',
                            oauth_token_secret: 'your value' })

Documentation available on rubydoc.info

• atom
• codeclimate
• minitest
• rubocop
• simplecov
• Thor
• tumblr
• Lions

1. Configure your test account configuration using $ dk setup and save it as default.
2. $ cp ~/.dkconfig ~/.dkconfig2
3. Update test/test_helper.rb to point to your test blog: $test_blog
4. $ rake

Bug reports and pull requests are welcome on GitHub at https://github.com/meissadia/tumblr_draftking.