--- name: "zophExport" section: "1" platform: "linux" package: "zoph" version: "0.8.0.1-1" release: "Debian 6.0 (Squeeze)" platforms: ["linux"] url: "https://new.carta.tech/zophExport" --- # zophExport(1) Export images from zoph to static albums ## NAME zophExport - Export images from zoph to static albums ## SYNTAX zophExport \[*--help*\] *--dir* dir *--format* zoph\|album\|bins \[*--album* "album"\] \[*--category* "category \[, category\]"\] \[*--photographer* "first\_name last\_name"\] \[*--people* "first\_name last\_name \[, first\_name last\_name\]"\] \[*--location* \["place\_title"\] \[*--field* name="value"\] \[*--sql* sql\_statement\] \[*--lang* file\] \[*--\[no\]albumdirs*\] \[*--\[no\]subalbums*\] \[*--\[no\]subcategories*\] \[*--\[no\]showdate*\] \[*--\[no\]showtitle*\] \[*--\[no\]showview*\] \[*--\[no\]showpeople*\] \[*--\[no\]showphotographer*\] \[*--\[no\]showlocation*\] \[*--\[no\]showdescription*\] \[*--\[no\]showexif*\] \[*--\[no\]showfooter*\] ## DESCRIPTION zophExport is the command line exporter for the zoph (Zoph Organizes PHotos) web photo management system. Specify the destination of the export using --dir and the format of the export using --format. The format must be one of "zoph", "album", or "bins". The zoph format creates a gallery using a simple, built-in generator. The album format creates an export compatible with the album program, the bins format creates an export compatible with the bins program.\ Photos can appear in multiple albums and categories, and multiple people can be in a photo. To handle this, you can either pass a comma separated list or set the flag multiple times. Actually, you can use a comma separated list for categories and people but not for albums (since I realized that I have many albums with commas in their names and have yet to build an escape mechanism).\ The exporter creates static albums in various formats to be used on webhosting services where you don't have MySQL, when you don't want all your pictures to be published or to burn them onto a CD for offline-browsing. Multiple options are ANDed, cutting down the resulting set of images. The set can be increased again by running zophExport multiple times. SQL hackers can select images by arbitrary SQL statements and finally the set of images can be modified manually before transfer to the web host or CD.\ Most fields match using the equals operator. Two exceptions are rating (which defaults to \>=) and description (which defaults to like). ## OPTIONS The \`"' around arguments are needed to prevent breaking up around whitespace or the shell interpreting special characters. If an album e.g. is called *hugo* you can omit them. - **--help** - lists all supported options and quits - **--dir** *dir* - toplevel directory for exported hierarchy - **--format zoph\|album\|bins** - the format to use: **zoph** is a very simple yet quick built-in format (the thumbnails don't have to be calculated, no additional software needed), **album** for David Ljung Madisons "Album" script (http://marginalhacks.com/Hacks/album/ ) and **bins** for Jérôme Sautrets "bins" script (http://bins.sautret.org/ ); both are available as Debian packages - **--album** *"album"* - select the album(s) to export - **--category** *"category \[, category\]"* - select the category(s) to export - **--photographer** *"first\_name last\_name"* - select the photographer whose pictures should be exported - **--people** *"first\_name last\_name \[, first\_name last\_name\]"* - select pictures by the people being shown - **--location** *"place\_title"* - select pictures by location being shown - **--field** *name="value"* - select pictures by its field *name*; common fields are title (text, 64 chars max), view (text, 64 chars max), description (text), rating (1..10) or level (1..10); possible fields are from the MySQL database, table photos; - **--sql** *sql\_statement* - select pictures by self-defined SQL statement - **--lang** *file* - The exporter can translate field labels using the same language files that Zoph uses. Pass --lang /usr/share/zoph/lang/XX to enable this option. The following options can be used with or without "no" prepended. The default behaviour is without "no", explained is the option when used with "no". - **--\[no\]albumdirs** - By default the exporter creates directories to mirror the structure of the albums in which the exported photos appear. Use this flag to disable this and have all images exported into the given directory *dir*. - **--\[no\]subalbums** - don't export subalbums below the selected one - **--\[no\]subcategories** - don't export subcategories below the selected one By default zophExport.pl will export everything about your photos except the last modified time, the rating and the albums or categories in which the photo appears. To prevent the display of a particular field, use the --noshowFIELD argument. For example: --noshowlocation or --noshowdescription. Passing --noshowexif prevents any exif info from being shown. (Note, however, that the BINS program extracts exif info on its own).\ - **--\[no\]showdate** - don't export the date - **--\[no\]showtitle** - don't export the title - **--\[no\]showview** - don't export the view - **--\[no\]showpeople** - don't export the people's names - **--\[no\]showphotographer** - don't export the photographer's name - **--\[no\]showlocation** - don't export the location - **--\[no\]showdescription** - don't export the description - **--\[no\]showexif** - don't export the Exif data - **--\[no\]showfooter** - don't show a footer ## EXAMPLES - zophExport --dir "~/Winter Pics" --format album --category Snow In this simple example all photos placed in the Snow category are exported. Within the "Winter Pics" directory zophExport will have created a directory structure mirroring the album structure in Zoph for the selected photos. - zophExport --dir "~/My Album" --format album --album "Boston Trip" --photographer "Jason Geiger" --field rating=5 Only photos I took on my trip to Boston that I rated 5 or more would be exported. By default subalbums of an album are automatically included (so my "Duck Tour" subalbum is also exported). ## CONFIGURATION FILE Configuration for both zophImport.pl and zophExport.pl are stored in *$HOME\\.* *zophrc*. An example file is included with Zoph. The following settings need to be made in order to make zophImport.pl and zophEx port.pl work:\ - **$db\_host:** - Hostname or IP address of your MySQL server. - **$db\_name:** - Name of the database.\ - **$db\_user:** - Username Zoph should use to log on to the MySQL server. - **$db\_pass:** - Password Zoph should use. - **$db\_prefix:** - Prefix to include before each tablename (in order to enable sharing of the Zoph database with other apps - for example if you have a limitted number of databases with your hosting account). - **$image\_dir:** - Location of your photos. Make sure it ends with **/**. Note that these settings should have a matching entry in **config.inc.php**. ## AUTHORS zoph was written by Jason Geiger \ and is now maintained by Jeroen Roos \ this manpage was created by Edelhard Becker \ and updated by Jeroen Roos \ ## SEE ALSO [zophImport(1)](/zophImport/1.md), http://localhost/doc/zoph/manual.html, http://en.wikibooks.org/wiki/Zoph\ http://marginalhacks.com/Hacks/album/\ http://bins.sautret.org/