Page 1 of 1

New app to export Control Page images for sharing

PostPosted: Fri Mar 04, 2016 12:46 pm
by raneil
Image


What

Control Page Images is a simple utility app used to export the images associated with each of your Indigo Control Pages. Or, to simply create a list (or multiple lists) of the images in one of several list file formats. Indigo’s Image Selection Heuristics rules are applied to ensure that all of the associated images are exported/listed.

Control Page Images requires Indigo v4, v5, or v6 and Mac OS X 10.9.x (Mavericks) or later*.


Where

Download link
Discussion


Why

Two reasons: sharing and file management.

Sharing
One of the great things about the Indigo community is the sense of sharing. But sharing Control Page images has always been a chore because it’s difficult to accurately identify the correct images for a given Control Page. Control Page Images makes it quick and easy to create an accurate collection of images for a given Control Page, organized in the same folder structure used by Indigo. Simply make a .ZIP archive of the app’s output, and share it with other Indigo users.

File Management
As your Control Pages evolve over time, the number of associated image files inevitably grows and grows. Keeping track of which ones are still being used and which ones have become obsolete is (or rather, was) a major pain. No longer. Use Control Page Images to quickly create accurate lists of which images are used with which Control Pages. Then you can safely delete or archive the others.


How

Control Page Images is very simple to use:

  1. Either quit the Indigo Server app, or make a copy of your Indigo database file. Parsing the database file can take a minute or so, and we don’t want the server making changes to the file while we’re parsing it.
  2. Launch Control Page Images.
  3. Open your Indigo database file:
    • Click on the Open Database icon on the toolbar
    • Choose File —> Open
    • Or simply drag your Indigo database file from the Finder and drop it on the app’s icon or main window.
  4. Be patient. If your Indigo database file is large, it can take a minute or so to locate all of the Control Pages and their associated image files.
  5. Select one or more Control Pages in the list.
  6. Click the Export Images toolbar icon and choose a destination folder. In the destination folder, the app will create one subfolder for each of the selected Control Pages. Within each of those subfolders, additional subfolders are created as needed to match those containing the original Control Page images (../backgrounds, ../controls/devices/, ../controls/static/, and ../controls/variables/). Each image is then copied to the appropriate subfolder. A detailed log file is also generated for each exported Control Page.
  7. Optionally, you can save a list (or multiple, separate lists) of image files for whatever purposes you see fit. Each list contains the following fields:
    • Control Page name
    • Base image filename, as stored in the Indigo database
    • Full path to the image file, including those used by the Control Page via Indigo’s Image Selection Heuristics rules
    • Subfolder (../backgrounds, ../controls/devices/, ../controls/static/, or ../controls/variables/)
    • Z-order

    Using the app’s preferences, select one of three available list file formats:
    • CSV (comma separated values)
    • TSV (tab separated values)
    • AppleScript list (.CPList file) — a sample AppleScript for reading a .CPList file is provided. It simply reads the file and creates an AppleScript list of records, with one record for each image. Each record is comprised of properties matching the fields listed above. See the sample AppleScript for more information.

Image
Control Page Images main window displaying the venerable “Sample House” database that ships with Indigo



* Compatibility notes:
  • If your Indigo server is running under Mac OS X 10.8 or earlier, and you have access to a Mac running OS X 10.9 Mavericks or later, you can simply copy your Indigo database file and the Control Page images source folder (/Library/Application Support/Perceptive Automation/Indigo 6/IndigoWebServer/images) from your server Mac to the Mavericks+ Mac. Use the app’s preferences to select the location of the copied Control Page images source folder.
  • All of the usual caveats and disclaimers apply: Control Page Images works as advertised on the following test systems, with the few Indigo database files available for testing. Specifically, testing/debugging was performed with:
    • Mac OS X 10.9.5 and Mac OS X 10.11.3
    • Indigo database files created with Indigo v4, v5, and v6.
    • Your mileage may vary, use at your own risk, etc., etc.

Re: New app to export Control Page images for sharing

PostPosted: Fri Mar 04, 2016 10:55 pm
by raneil
The Download link above has been updated to version 1.0.1. The 1.0.0 disk image previously linked inadvertently contained an unsigned/development version of the app.

Version 1.0.1 is properly code-signed, and plays nicely with Gatekeeper. Sorry about that. :oops:

Re: New app to export Control Page images for sharing

PostPosted: Sat Mar 05, 2016 3:20 am
by durosity
Nice work! I've got hundreds of obsolete files that need binning, this will make life so much easier!!


Sent from my iPad using Tapatalk

Re: New app to export Control Page images for sharing

PostPosted: Mon Mar 21, 2016 10:18 am
by jay (support)
Excellent tool - thanks for creating and sharing!