https://github.com/leplatrem/pyfspot

pyfspot is a python application which allows you to perform and script
operations on your F-Spot (http://f-spot.org) photo collection.

The command-line application allows you to query your collection (tags, paths),
modify photos attributes (ratings, tags), and diagnostic problems (find missing on disk etc.)

But you can also build your own script using pyfspot modules.


=======
INSTALL
=======

pyfspot requires:
* sqlalchemy
* pexif
* fixtures (optional)

System-wide installation
------------------------
$ sudo aptitude install python-setuptools
$
$ sudo python setup.py install


Virtualenv installation
-----------------------
$ sudo aptitude install python-virtualenv
$
$ virtualenv env
$ cd env
$ source bin/activate
$ python setup.py install


=====
USAGE
=====

  f-spot-admin [options]

    Options:
      -h, --help            show this help message and exit
      --database=DATABASE   Path to F-Spot database
      --log-level=LOG_LEVEL
                            Logging level for messages (1:debug 2:info, 3:warning,
                            4:errors, 5:critical)

      Queries:
        --find-path=FIND_PATH
                            Find by path
        --find-tag=FIND_TAG
                            Find by tag
        --find-missing      Find photos missing on disk
        --find-corrupted    Find corrupted Jpeg photos

      Actions:
        --list              List photos matching set
        --rating=RATING     Change rating
        --safe-rating       Change rating only if superior to current
        --tag=TAG           Apply specified tag
        --untag=UNTAG       Remove specified tag

Examples
--------
List all photos of database:
  f-spot-admin --list

Find all photos on a specific partition:
  f-spot-admin --find-path="/media/ext-disk/*" --list

Rate all photos with tag "family" with "canon" in file paths:  
  f-spot-admin --find-tag="family" --find-path="*canon*" --rating=2

Tag and rate all photos whose path contains "selecta":
  f-spot-admin --find-path="*selecta*" --tag="selection" --rating=1

Remove tag on all photos which are missing on disk:
  f-spot-admin --find-missing --untag="Family"

Move corrupted photos to a specific folder
  f-spot-admin --find-corrupted --list | xargs -0 -I xxx mv xxx /tmp/trash


=======
AUTHORS
=======

    * Mathieu Leplatre <contact@mathieu-leplatre.info>

=======
LICENSE
=======

    * Lesser GNU Public License

=========
CHANGELOG
=========

0.3
---
* Fix command-line actions

0.2
---
* Ability to find missing photos on disk
* Ability to add/remove tag from command-line
* Fix encoding of paths in database
* Fix command-line args

0.1
---
* Initial version. Basic wiring of code and logics. Does basic path and tag search.