PhotoDB 0.1.0

App for cataloguing vintage cameras, lenses, films, negatives & prints

PhotoDB

PhotoDB is a web app for film photography that can be used to track cameras, lenses, accessories, films, negatives and prints, to fully catalogue a collection of photographic equipment as well as the pictures that are made with them. Read the Concepts section for full details on the capabilities of PhotoDB.

It replaces an earlier command-line project, also called PhotoDB, which has now been deprecated.

Installing PhotoDB

From source

This method of installation is required if you want to work on the source code. To install PhotoDB from source, clone this repo and run these steps to create a virtualenv with all the dependencies:

git clone https://github.com/djjudas21/photodb.git
cd photodb
virtualenv venv
source venv/bin/activate
pip install .

PhotoDB will run out of the box with no additional configuration, by creating an SQLite database in its own directory.

If you wish to use an external database then copy photodb/local_settings/local_settings.py.template to photodb/local_settings/local_settings.py and customise the database settings for your environment.

After the database is configured, apply the migrations and create your user account:

python manage.py migrate
python manage.py createsuperuser

To run PhotoDB, run:

python manage.py runserver

and navigate to http://localhost:8000. Log in with the superuser account you created above.

With Docker

To create a named container running PhotoDB, use the following command. You can change the -p settings if you wish to serve PhotoDB on a different port.

A persistent volume will be created to store the SQLite database file.

To provide additional config, e.g. connection info for external databases, create a config file ~/photodb/local_settings.py with your settings in. This will be mounted into the container.

docker create --name photodb --mount source=photodb-sqlite,target=/var/www/photodb/db -v "$HOME/photodb":/var/www/photodb/photodb/local_settings -p 8000:8000 djjudas21/photodb

Start PhotoDB by running:

docker start photodb

and navigate to http://localhost:8000. Login with default username admin and password admin.

See also

• Concepts
• Screenshots
• Contributing