Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Perform operations on your F-Spot database.

Project Description

pyfspot is a python application which allows you to perform and script
operations on your F-Spot ( 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.


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

System-wide installation
$ sudo python install

Virtualenv installation
$ virtualenv env
$ cd env
$ source bin/activate
$ python install


f-spot-admin [options]

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

Find by path
Find by tag
--find-missing Find photos missing on disk

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

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"


* Mathieu Leplatre <>


* Lesser GNU Public License


* Fix command-line actions

* 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

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

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(8.3 kB) Copy SHA256 Hash SHA256
Source None Feb 7, 2011

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate