Metadata-Version: 2.1
Name: camerahub
Version: 0.30.1
Summary: App for cataloguing vintage cameras, lenses, films, negatives & prints
Home-page: https://camerahub.info/
License: Apache-2.0
Author: Jonathan Gazeley
Author-email: camerahub@jonathangazeley.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Database
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Provides-Extra: pgsql
Requires-Dist: Django (>=2.2.13,<3.0.0)
Requires-Dist: awesome-slugify (>=1.6.5,<2.0.0)
Requires-Dist: django-2-collectionfield (>=0.0.4,<0.0.5)
Requires-Dist: django-autocomplete-light (>=3.8.1,<4.0.0)
Requires-Dist: django-autosequence (>=0,<1)
Requires-Dist: django-bootstrap-datepicker-plus (>=3.0.5,<4.0.0)
Requires-Dist: django-choices (>=1.7.0,<2.0.0)
Requires-Dist: django-countries (>=6.1.3,<7.0.0)
Requires-Dist: django-crispy-forms (>=1.9.0,<2.0.0)
Requires-Dist: django-currentuser (>=0.5,<0.6)
Requires-Dist: django-dbbackup (>=3.3.0,<4.0.0)
Requires-Dist: django-filter (>=2.2,<3.0)
Requires-Dist: django-fullurl (>=1,<2)
Requires-Dist: django-geoposition-2 (>=0.3.11,<0.4.0)
Requires-Dist: django-leaflet (>=0.27.1,<0.28.0)
Requires-Dist: django-money (>=0.15,<0.16)
Requires-Dist: django-prometheus (>=2.0.0,<3.0.0)
Requires-Dist: django-redis (>=4.11,<5.0)
Requires-Dist: django-registration (>=3.0,<4.0)
Requires-Dist: django-sendgrid-v5 (>=0,<1)
Requires-Dist: django-simple-history (>=2.11.0,<3.0.0)
Requires-Dist: django-social-share (>=2.0.0,<3.0.0)
Requires-Dist: django-star-ratings (==0.9.0)
Requires-Dist: django-tables2 (>=2.1.1,<3.0.0)
Requires-Dist: django-taggit (>=1,<2)
Requires-Dist: django-versatileimagefield (>=2.0,<3.0)
Requires-Dist: django-watson (>=1.5.5,<2.0.0)
Requires-Dist: djangorestframework (>=3.12.1,<4.0.0)
Requires-Dist: drf-generators (>=0.5.0,<0.6.0)
Requires-Dist: drf-multiple-serializer (>=0.2.3,<0.3.0)
Requires-Dist: numpy (>=1.19.1,<2.0.0)
Requires-Dist: poetry-version
Requires-Dist: psycopg2-binary (>=2.8,<3.0); extra == "pgsql"
Requires-Dist: pytz
Requires-Dist: pyyaml (>=5.4.1,<6.0.0)
Requires-Dist: uWSGI (>=2.0.0,<3.0.0)
Requires-Dist: uritemplate (>=3.0.1,<4.0.0)
Project-URL: Repository, https://github.com/camerahub/camerahub
Description-Content-Type: text/markdown

# CameraHub

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

It replaces an earlier command-line project, called [PhotoDB](https://github.com/djjudas21/photodb-perl), which has now been deprecated.

## Installing CameraHub

There are several ways of installing CameraHub, depending on your needs:

* With Pip
* [From source](docs/INSTALL_SOURCE.md)
* [With Docker](docs/INSTALL-DOCKER.md)
* [With Kubernetes](docs/INSTALL-KUBERNETES.md)

## Configuring CameraHub

CameraHub requires almost no additional config to run with default settings. However it is insecure in this configuration so at least `CAMERAHUB_SECRET_KEY` and
`CAMERAHUB_PROD` must be set if you are running in production.

The following environment variables are supported:

### `CAMERAHUB_ADMIN_EMAIL`

Email address for the `admin` account
Default: `admin@example.com`

### `CAMERAHUB_ADMIN_PASSWORD`

Password for the `admin` account
Default: `admin`

### `CAMERAHUB_DB_ENGINE`

[Database engine](https://docs.djangoproject.com/en/3.0/ref/settings/#engine)
Default: `django.db.backends.sqlite3`

### `CAMERAHUB_DB_HOST`

[Database hostname or IP address](https://docs.djangoproject.com/en/3.0/ref/settings/#host) if an engine other than SQLite is configured

### `CAMERAHUB_DB_NAME`

[Database schema or path to SQLite db](https://docs.djangoproject.com/en/3.0/ref/settings/#name)
`db/db.sqlite3`

### `CAMERAHUB_DB_PASS`

[Database password](https://docs.djangoproject.com/en/3.0/ref/settings/#password) if an engine other than SQLite is configured

### `CAMERAHUB_DB_PORT`

[Database port](https://docs.djangoproject.com/en/3.0/ref/settings/#port) if an engine other than SQLite is configured

### `CAMERAHUB_DB_USER`

[Database username](https://docs.djangoproject.com/en/3.0/ref/settings/#user) if an engine other than SQLite is configured

### `CAMERAHUB_PROD`

Enable [Django production mode](https://docs.djangoproject.com/en/3.0/ref/settings/#debug)
Default: `false`

### `CAMERAHUB_SECRET_KEY`

Random secret value. The default string is for testing only and is insecure in production. Generate a new one [here](https://miniwebtool.com/django-secret-key-generator/)
Default: `OverrideMe!`

### `CAMERAHUB_EMAIL_BACKEND`

[Email backend](https://docs.djangoproject.com/en/3.1/topics/email/#email-backends)
Default: `django.core.mail.backends.filebased.EmailBackend`

### `CAMERAHUB_SENDGRID_KEY`

API key for Sendgrid email backend

### `CAMERAHUB_EMAIL_USE_TLS`'

Enable TLS for SMTP

### `CAMERAHUB_EMAIL_USE_SSL`'

Enable TLS for SMTP

### `CAMERAHUB_EMAIL_HOST`

SMTP server hostname

### `CAMERAHUB_EMAIL_HOST_USER`

SMTP server username

### `CAMERAHUB_EMAIL_HOST_PASSWORD`

SMTP server password

### `CAMERAHUB_EMAIL_PORT`

SMTP server port number

### `CAMERAHUB_FROM_EMAIL`

[From email address](https://docs.djangoproject.com/en/3.0/ref/settings/#default-from-email)
Default: `noreply@camerahub.info`

### `CAMERAHUB_DOMAIN`

[Site domain](https://docs.djangoproject.com/en/3.0/ref/settings/#allowed-hosts)
Default: `camerahub.info`

### `CAMERAHUB_REDIS`

Enable [Redis caching](https://docs.djangoproject.com/en/3.0/topics/cache/)
Default: `false`

### `CAMERAHUB_REDIS_HOST`

Redis hostname or IP address
Default: `127.0.0.1`

### `CAMERAHUB_REDIS_PORT`

Redis port
Default: `6379`

## See also

* [Screenshots](docs/SCREENSHOTS.md)
* [Contributing](docs/CONTRIBUTING.md)
* [Changelog](https://github.com/camerahub/camerahub/releases)
* [Icons](docs/ICONS.md)
* [API](docs/API.md)
* [Operations](docs/OPS.md)

