pyfspot 0.3

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 python setup.py install


Virtualenv installation
-----------------------
$ 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

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"


=======
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.