# =============================================================================
# Popcorn Vote – environment variables for docker-compose.yml
#
# 1. Copy this file next to docker-compose.yml as .env
# 2. Fill in at least the three required values
# 3. `docker compose up -d`
#
# The .env itself does not belong anywhere others can read it: it holds the
# family PIN and the access keys. It is therefore excluded in .gitignore; only
# this template is in the repository.
#
# Empty values count as not set. Whatever stays empty here comes from config.yaml
# in the data directory (template: config.example.yaml) or from the built-in
# default, an empty line here overrides nothing. If a value is set in both
# places, the one from this file wins and the app logs "is configured twice" at
# startup.
#
# This file and config.example.yaml list all supported settings.
# =============================================================================

# --- Required ----------------------------------------------------------------

# Optional legacy shared PIN. Leave empty for named-account browser setup.
PV_PIN=

# Automatic logout after this many inactive seconds (300 to 31536000).
# PV_SESSION_TIMEOUT=31536000

# Access keys for the movie databases, both free.
# TMDB: https://www.themoviedb.org/settings/api   (search, covers, trailers)
# OMDb: https://www.omdbapi.com/apikey.aspx       (IMDb rating)
TMDB_API_KEY=
OMDB_API_KEY=

# --- Who is playing? Only needed without a config.yaml ------------------------

# Title in the top left of the app. Without one it says "Popcorn Vote".
PV_TITLE=

# The family members, comma separated: PV_MEMBERS=Anna,Ben,Carla,David
# Colours and emoji need the config.yaml.
PV_MEMBERS=

# Options for "where to find it": PV_SOURCES=Netflix,Google,Server
PV_SOURCES=

# Starting balance for new people (1–99).
PV_START_TOKENS=

# --- Game values, language, timezone, backup ----------------------------------
# Unusable values are ignored with a warning and do not displace the config.yaml.

# Weekly vote credit: amount, weekday (sunday…saturday or 0–6), whole hour
# (0–23) and the cap for unused votes (1–99). The settings use the TOKEN prefix.
PV_TOKEN_AMOUNT=
PV_TOKEN_WEEKDAY=
PV_TOKEN_HOUR=
PV_TOKEN_CAP=

# Language of the interface: en, de, es, fr, pt-BR, it, pl, tr, or ja. Unset: en.
PV_INTERFACE_LANGUAGE=

# Language of the movie data from the movie database, a different thing from
# the line above. Unset: 'latin', which takes the film's own title where it is
# written in Latin letters and the English one otherwise; description, genres and
# poster come in English, or in German for German-language films. PV_LANGUAGE
# also accepts 'original' and any language code. PV_LANGUAGE_FALLBACK accepts
# neither placeholder, its value goes to the movie database unchanged, and it
# is what 'latin' requests for every film that is not German.
PV_LANGUAGE=
PV_LANGUAGE_FALLBACK=

# Country whose age rating is shown (for example DE), independent of the
# language above, and the order of preference for trailer languages (for example
# original,en,de). 'latin' means nothing here and is ignored.
PV_CERTIFICATION_COUNTRY=
PV_TRAILER_LANGS=

# Timezone for the credit and the backup, for example Europe/Berlin.
PV_TIMEZONE=

# Nightly backup: whole hour (0–23) and how many backups are kept.
PV_BACKUP_HOUR=
PV_BACKUP_KEEP=

# How much ends up in the container log: debug, info (default), warn or error.
# Errors are written whatever this says. One JSON line per event, so the log can
# be filtered, `docker logs popcorn-vote 2>&1 | jq -R 'fromjson? | select(.level=="error")'`.
# Every unexpected error carries a short reference that the app also shows on
# screen, which is how a report from the family finds its line weeks later.
LOG_LEVEL=

# --- Test instances only ------------------------------------------------------

# Fills list, archive, log and trash with example content on first start, so
# that a fresh test instance has something to show. Applies exclusively to a
# completely empty movie table, nothing can ever appear this way in a running
# family installation.
PV_DEMO_DATA=

# A link under "More" to a daily build: a second instance of your own on the
# newest code, whose data is thrown away. Both are needed, the switch so the
# link can be taken down without deleting the address, the address because there
# is no default one. Only http and https are accepted; the value goes into a link
# the family clicks, so anything else is refused with a line in the log.
PV_DAILY_BUILD=
PV_DAILY_BUILD_URL=