shinywhitebox

iShowU HD & HD Pro

Adding your own upload script

iShowU HD isn't just limited to YouTube. We've included the ability for users to add further scripts with the intention of folding popular scripts into the product.

This page will provide a brief overview of the kinds of tasks required in order to create a new upload script.

For further information, we recommend going to the forums (there's a specific forum for upload script development).

Developer Forum

Download the sample YouTube script (ZIP file)

For the YouTube uploader, we chose Python for implementation. This is because it has a wide variety of third party classes available for various connection oriented tasks. Also, Dave likes Python :-)

iShowU HD presume that the script follows a certain interface.

Introduction / Overview

$ ./isuhd-youtube-upload.py --help
Usage: isuhd-youtube-upload.py [options] file

Options:
  -h, --help            show this help message and exit
  -u USERNAME, --username=USERNAME
                        The account to upload to
  -p PASSWORD, --password=PASSWORD
                        The account's password
  -z DEVKEY, --devkey=DEVKEY
                        The Developer Key
  -t TITLE, --title=TITLE
                        The movie's 'as displayed' title
  -c CATEGORY, --category=CATEGORY
                        The short form category
  -d DESCRIPTION, --description=DESCRIPTION
                        A text description (in quotes) for the movie
  -k KEYWORDS, --keyword=KEYWORDS
                        Add a keyword, feel free to call multiple times
  --list-requirements   List required parameters
  --list-options        List optional parameters
  --list-categories=LIST_CATEGORIES_LANGUAGE
                        List available categories (pass locale - i.e. en-US)

The user interface will call the script (the various --list-xxx commands) to gather information such as the media categories and what options are required / supported by the service being uploaded to.

There is further documentation (available above) that describes the expected inputs and outputs to the script. Please read this to see what is expected.

Installation is a matter of placing two files in a known directory location. One being an image and the other the script. iShowU HD will automatically discover services when it starts.

For full documentation, please click on the link at the top right of this page.

Development API and documentation (not yet available - under development itself)