Files
hassio-addons/birdnet-pipy/DOCS.md
Yudong Sun 33000347b4 birdnet-pipy: remove TZ option — timezone auto-derived from station location
The app derives its timezone from station lat/lng via timezonefinder
(Settings → Location in the Web UI), so a separate addon-level TZ only
ever created mismatch with the UI-derived zone. All app-facing timestamps
(dashboard, API, DB) and Python service stdout (api/main/birdnet) already
honor the UI zone via logging_config.py's formatter, and the frontend log
viewer re-converts Icecast timestamps on read.

Net effect in the HA addon log pane: Python services still show the
correct local time; only Icecast's raw stdout now prints in UTC (accepted
trade for a single source of truth). Deletes
rootfs/etc/cont-init.d/02-timezone.sh added in 0.5.6-2.

Also cleans up the options YAML in DOCS.md/README.md: drops
RECORDING_MODE and RTSP_URL (never wired — app reads them from
user_settings.json), drops http_stream from the modes list, and moves
STREAM_BITRATE under an env_vars: example since it's honored by
start-icecast.sh but not a schema option.

Bumped to 0.6.3-2 (addon-only, no upstream app change).
2026-04-15 08:54:17 -04:00

845 B

BirdNET-PiPy add-on

Installation

  1. Add this repository to your Home Assistant add-on store.
  2. Install the BirdNET-PiPy add-on.
  3. Configure the options and start the add-on.
  4. Open the Web UI.

Access

  • Ingress: Use the Home Assistant sidebar entry.
  • Direct: http://<host>:8011 (or the port you configure)

Options

ICECAST_PASSWORD: "" # Optional: persistent password for the Icecast audio stream
data_location: /config/data # Persistent data location (under /config, /share, or /data)
env_vars: # Optional: extra environment variables
  - name: STREAM_BITRATE
    value: 320k # Icecast mp3 stream bitrate (default 320k)

Audio

The add-on expects audio via PulseAudio (default) or an RTSP stream. Pick the source in the BirdNET-PiPy Web UI under Settings → Audio after the add-on first starts.