Tumblingjazz Documentation

Documentation for Tumblingjazz - Tumblr bot / automation software


Got any questions? Come to the forum

Upload Specified Images

../images/post_images_from_folder.png

To upload specified images from a folder, enter the path to the folder in the box at the top left of the tab, or to select the folder, click the button "...". To import the images, click the ADD button.

Your images will now appear in the IMAGE LIST, you should see the FILENAME column shows the file name and the other columns (meta columns) are empty.

The meta data you can set for an image includes: * Title * Description * Tags * URL Stub * Click Thru * Source URL * Photoshoot ID

This meta data can be set a number of ways

Custom Caption per Image

../images/add_image_custom_caption.png

Double click the image and specify the exact meta data for each image

Randomised Token Meta Generation

../images/image_meta.png

Click the ASSIGN META button to view the Meta Generation form.

The Assign Meta form allows you to specify randomised Tags and Description for your post. The control is a TumJazz standard keyword token form you will use throughout the program and will allow spintax and tokens to be used for all values.

The inputs on the left are your meta values and the list input on the right is for your keywords. The meta inputs all can take the %kw% token. This token will be replaced by a random keyword that you specify in the keywords box on the right (one keyword per line). Additionally, for more control of what keywords to use, you can also use tokens %kw1% %kw2% and those specific keywords will be replaced

The Meta Description box will be treated as a single description box. However, if you want to enter multiple descriptions to be used sequentially, you can use the separate token *** eg

This would be my first description \*\*\*
This would
be the second
\*\*\*
and this is the third

The meta URL click through has a percentage control, this allows you to specify how often to include the click thru, including it on every image can be a footprint

Meta Tokens

There are various tokens you can use in your image posts. These include:

  • %filename% - the filename of the image
  • %filenameclean% - the filename of the image without extension
  • %blog% - the blog URL of the account posting the image
  • ((bitly)http://urltoshorten.com)
  • ((bitly-rand)http://urltoshorten.com) will be a different bitly each time

Meta Syndication Tokens

If you are syndicating your content, you can use

  • %SYND_URL% the URL to the image as uploaded to your wordpress / blogger blogs
  • %SYND_URL_SHORT% a shortened URL to the image as uploaded to your wordpress / blogger blogs - requires shortner URL details to be added to the settings tab
  • ((SYND)any text to include on your syndicated post but not your tumblr post)
  • ((TUM)any text to include on your syndicated post but not your tumblr post)

Import and Export Meta Description Setups

TumJazz will reload the previous meta description you specified. However, perhaps you want different meta setups depending on the account you are working with. In this case you can save the meta values via the EXPORT link, then reload them using the IMPORT link.

Load From Desc File

Another way to set the meta data, is to load the images via a file. The file should be laid out: filepath%title%desc%stub%tags%clickthru%source%photoshootId

i.e. c:imagesimg1.jpg%an image of a lovely sunset%a photo I took on holiday last year%sunset-holiday%#sunset,#beauty etc

This allows you to load in specified images with a specified caption, rather than going the random approach

Photoshoot

Tumblr allows you to include multiple images in a single post. To group together images as a photo shoot, check the rows in the list of images and right click

../images/photoshoot.png

you will then see the images labelled with a unique photoshoot ID in the images list view

Upload Image Settings

Standard Search Action Parameters

Random Pause:

Specify a minimum and maximum value, after actioning an item the action will pause for a random amount between the specified minimum and maximum values.

Max Actions / Max items:

The number of items to process within the action.

Fluctuate +-:

If you are repeating your action, you may not want to action on the the same number of items each action (avoiding footprints, so you can fluctuate the number of items to perform. If you specify 100 Max Actions and a Fluctuate value of 10. Then your action will random perform 90-110 items (100 +/- 10)

Time period:

The time period control will pre-populate the random pause values based on the MAX ACTIONS value that will be calculated at actioning the items evenly over the specified time period. For example, specify the action to have a Max Actions value of 100 and set Time Period to 1 day. That means, do 100 items over 24 hours, thus the random pause will be calculated at 864 seconds.

Repeat Hours + after checkbox:

Once the action has completed, wait the specified hours then repeat. Set it to 24 to repeat every day, set it to 12 to repeat twice a day etc. The checkbox "after" means the time is added on after the action completes. Unchecking the option means it is added on to when the action starts. So if the action starts at 0900 and completes at 0930. If your repeat hours value is 1, then with after checked the action starts again at 1030 (1 hour after it completed, with after NOT checked, the action repeats at 1000, an hour after it started

Schedule / Daily Runner

Using the schedule control you can specify when your action should run. The other scheduling option is Daily Runner. This will make sure the action runs at the same time every day. eg. Daily Runner 2pm. At 2pm (14:00) the action will start, then on completion schedule itself for 2pm / 1400 the next day

Share Across Accounts

Typically, the action will be created using one account to process the specified items. However, by bulk selecting accounts and checking this option, you can have the selected accounts share the items to be processed. eg you specify 100 items and select 10 accounts and check SHARE ACROSS ACCOUNTS. Then each account will process 10 items. More information in the Share across accounts section. If you select multiple accounts to perform the action, but DO NOT check this option, then each account will process all items, i.e. they will duplicate the items. When performing a Share Across Accounts action, then all accounts within the action will be aware of what the other accounts processed and will log this as if they processed the item, meaning in future actions the accounts will never re-process any items processed by any other account from the shared action

Unique Items Per Account / Action once

This option will ensure you do not reprocess the same items. So if you are performing a follow action, once you have followed an account you will never follow that account again, even if you have unfollowed them since. This also works for items processed by other accounts within a Share across accounts action and any items logged in a global processed log (for information on global processed logs, please see the revelevant section)

Watermark Text

../images/watermark.png

When uploading an image, you can specify text to be written onto the image. The text can be written to any of the 4 corners, or a bar can be added to the top or bottom of the image and the text written in the bar.

Max Size

You can specify the maximum dimension of the image to upload, any images that contain a dimension over this will be resized automatically. Applied to images posted to tumblr and any syndicated images. More information on syndication in the syndication section

Resized for Tumblr

You can specify the dimensions of the image to post to Tumblr. Any image larger than this will be automatically resized. This setting is similar ot the Max Size option, however it is different if you are Syndicating your image to wordpress / blogger this value is only applied to the image when posted to tumblr, the full size image will be syndicated. More information on syndication in the syndication section

Image Quality

You can reduce the quality of the image when posting to Tumblr

Tumblr Schedule

Check this option and your post will be sent to Tumblr straight away, but it will be scheduled by Tumblr to post at the specified time. Unchecked and the action will be scheduled to run in TumJazz at the specified time

Queue Images

Your images will be queued by Tumblr and dripped to your blog based on your Tumblr Queue settings (these can be edited via the Update Accounts tab in TumJazz

Alphabetical / Unchecked Random

Check this option to upload your images alphabetically, unchecked and the order is random

Unique Uploads Only

Ensure you do not upload the same image twice

Delete Local Image After

Check this option and the image on your local hard drive will be deleted after it is uploaded. After the image is deleted there is no getting it back so make sure you really mean to delete it before checking this

Syndicated Template

If you are syndicating your content, you can specify an HTML posting template on how your post will be created on your syndicated blog.

../images/syndicated_post_template.png