RB Inventory by Marjolein Katsma
A set of scripts with which a RedBubble member can create a complete inventory of all their public work on RedBubble.
Bookmark and Share

What is this?

RB Inventory is a set of scripts with which a RedBubble member can create a complete inventory of all their public art, calendars, clothing and writing on RedBubble, with title, description, all tags, and other meta data.

The inventory can be imported into a spreadsheet, a database, or be used as the source data for future scripts.

Current version: 1.0 - 2010-09-05

What does it do?

RB Inventory works with scripts and macros that analyze the structure of web pages and extract information from them. Since each type of work page on RedBubble has a different structure, a different scripts are needed for each. Gllobally, though, they all work along the same lines:

An RB Inventory script goes through your public Art, Calendar, Clothing or Writing pages (as many as you let it in one go), and records:

  • The page address (URL)
  • A work (page) ID (derived from the URL): internal RedBubble ID without a sequence number
  • All items in the 'Information' box on the Edit page, including original name of the uploaded image file
  • All textual information from the Edit form:
    • title
    • description in RedBubble markup format
    • all tags
    • the state of each of the media checkboxes
  • The description again as rendered in HTML format
  • A timestamp of when all this data was gathered

The description is written to two separate files, both with the ID as the name part; the RedBubble format is stored in a .txt file, the HTML is stored in a .html file.

All other data is stored as a single record in a file in CSV format, which can easily be imported into a spreadsheet or database.

Note that this script cannot store an image thumbnail, because that is not found on an individual work page. Another script (to be developed) may provide this functionality, storing thumbnails also using the ID as file name, so it can all be tied together.

What do you need?

Note: There are different scripts (because page layouts differ) for Art, Calendars, Clothing and Writing. You can get only the ones you really need (download them from their respective pages), or download them all as one complete package from this page (download link below).

To use any RB Inventory script, you basically need three pieces of software:

  1. The Firefox browser, version 3.0 or higher. Free, open source software.

    Apart from Firefox, you also need 256MB of RAM (512MB recommended) and at least 10 MB of available hard-disk space.

  2. The iMacros Extension for Firefox, version 6.7 (current production release) or higher. Free (as in beer), but not Open Source.

  3. Download RB Inventory - this is a ZIP archive.
    Current version:
    1.0 - 2010-09-05

    The actual RB Inventory package.

    Once you've downloaded the archive, extract it into the iMacros 'Macros' folder (for which you've noted the path in the previous step).

    This package consists of 11 files:

    • RB_Inventory_A.js - a JavaScript script that calls the corresponding macro once for each Art page and writes the inventory data files
    • RB_Inventory_A.iim - the iMacros macro for Art pages
    • RB_Inventory_C.js - a JavaScript script that calls the corresponding macro once for each Calendar page and writes the inventory data files
    • RB_Inventory_C.iim - the iMacros macro for Calendar pages
    • RB_Inventory_T.js - a JavaScript script that calls the corresponding macro once for each Clothnig page and writes the inventory data files
    • RB_Inventory_T.iim - the iMacros macro for Clothing pages
    • RB_Inventory_W.js - a JavaScript script that calls the corresponding macro once for each Writing page and writes the inventory data files
    • RB_Inventory_W.iim - the iMacros macro for Writing pages
    • RB_back.iim - a small macro to go back to the previous page
    • RB_refresh.iim - a small macro to reload the curent page
    • LGPLv3.txt - the text of the license

Once you have extracted the ZIP package(s), you can start iMacros again: you can check whether the files mentioned above are now actually visible in the file list at the top. (If not, go back and repeat the last step!)

Problems or bugs?

If you are getting really stuck, or if you think you found a bug, you can contact me by BubbleMail (this link will only work if you actually are a RedBubble member and are logged in), or via my contact form. The first option is by far the best and you may reach me sooner, but please remember that I do not watch my bubble mail every hour of the day...

Of course, if you have any brilliant ideas for improvement or possible new scripts, also let me know. No guarantees as to feasibility, but I'll certainly consider your valuable suggestions. Or, since it's all Free, Open Source Software, you may want to make your own changes or additions, and share those with the world! Please make sure to actually read the license included in the package before you plan to distribute any modifications!