Andrew Sterling Hanenkamp > Net-Google-PicasaWeb-0.11 > picasa-get

Download:
Net-Google-PicasaWeb-0.11.tar.gz

Annotate this POD

CPAN RT

New  3
Open  4
View/Report Bugs
Source   Latest Release: Net-Google-PicasaWeb-0.12

NAME ^

picasa-get - fetch albums and photos from Google Picasa Web

VERSION ^

version 0.11

SYNOPSIS ^

  picasa-get [options]

  Options:
    --username <username>        the username to login as
    --password <password>        the password to login with

    --kind <kind>                either "album" or "photo" (default: album)
    --user-id <user-id>          the user ID to look for albums or photos in 
    --album-id <album-id>        the album ID to look for photos in
                                 (use multiple times to get more than one)

    --find-photo <field>=<value> Limit to photos just matching this rule
    --find-photo <field>=<regex> Limit to photos just matching the Perl regex

    --find-album <field>=<value> Limit to albums just matching this rule
    --find-album <field>=<regex> Limit to albums just matching the Perl regex

    --option <key>=<value>       special options: q, location, etc.

    --update                     add files to existing directories

    --dry-run                    show what would be downloaded
    --quiet                      suppress messages
    
    --help                       get some help
    --man                        get lots of help

DESCRIPTION ^

This script will download photos from the Picasa Web site based upon a query you give. This will download all files into the current working directory. If albums are downloaded (the default unless --kind is set to "photo"), subdirectories will be created for each album and the photos will be placed within those.

NAME ^

picasa-get - fetch albums and photos from Google Picasa Web

OPTIONS ^

--username

This is the Google username to use when logging in. This is generally a GMail address or another email address used to login to Google services.

--password

This is the Google password to use when loggin in.

--kind

This is the kind of information to pull. There are two possible settings:

album

This is the default. If albums are pulled, each album found will cause a directory to be created in the current working directory. Then, all the photos in the album will be placed in that directory.

photo

The matching photos will be pulled and saved into the current working directory.

--user-id

This is the Google user ID to use to pull from.

If --kind is not given or is set to "album", then the default is to use the "default" user ID. This special identifier tells Google to pull for the currently authenticated user (which won't work if you're not authenticated, so specify --user-id if you don't specify --username).

If --kind is set to "photo", then the default is not to set this at all, but to pull photos from the general picasa community. You may set this to "default" to user the logged username or a specific user ID.

--album-id

This is the ID of the album to use when fetching photos. This option can be used more than once to specify multiple albums to fetch.

--find-album
--find-photo

This option allows you to specify additional rules to match albums or photos by. This option can be used more than once to require additional rules. Each rule is given with a field name followed by either "=" to specify and exact match or "=~" to specify a Perl regular expression match, finally with the value to match. For example, to match only those albums containing "2008" in the name, you could run:

  picasa-list --kind album --username example --find-album title=~2008

This would download only images attached to albums with "2008" in the title.

Here is a list of fields you can compare against:

  • id
  • url
  • title
  • summary
  • author_name
  • author_uri
  • entry_id
  • user_id
--option

This option allows you to specify arbitrary options on the Picasa Web query. To see a list of available options, check "STANDARD LIST OPTIONS" in Net::Google::PicasaWeb.

--update

Normally, if a directory matching the name of an album already exists, this utility will not enter that directory and write photos into it. If this option is given, it will go ahead and do so.

--dry-run

If given, no directories will be created and no files will be downloaded. The script will go through the process of describing what it would do if this option weren't set.

--quiet

If given, the typical status output will be surpressed.

--help

Show some of this help stuff.

--man

Show lots of help.

AUTHOR ^

Andrew Sterling Hanenkamp, <hanenkamp at cpan.org>

COPYRIGHT & LICENSE ^

Copyright 2008 Andrew Sterling Hanenkamp

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR ^

Andrew Sterling Hanenkamp <hanenkamp@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2011 by Andrew Sterling Hanenkamp.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: