Configuration

Edit PiPiece environment settings — things like where photos are stored or which features are enabled.

Editing Settings

Configuration is a simple table of key-value pairs. Click any Key or Value cell to edit it inline.

Add a setting

Click + Add Row at the bottom. Type the key and value, then click Save.

Remove a setting

Click the × button on the row you want to remove, then click Save.

Save changes

Click 💾 Save. Changes take effect immediately — no restart needed for most settings.

Discard changes

Click 🔄 Reload to throw away any unsaved edits and reload the current saved values.

Key Format

Setting names (keys) must be uppercase environment variable format: letters, numbers, and underscores only, starting with a letter or underscore.

Valid: PHOTOS_DIR, CONFIG_DIR, MY_SETTING_123

Invalid: photosDir (lowercase), 123VAR (starts with number), VAR-NAME (hyphen)

Common Settings

Key	What it controls
PHOTOS_DIR	Where captures are saved
CONFIG_DIR	Where configuration files live
PIPIECE_AUTO_UPDATE	Set to true to enable daily auto-updates
PIPIECE_UPDATE_TIME	Time for auto-update checks (HH:MM, 24h)

Astro live stacking adds its own settings — the plate solver, its search radius, and the calibration toggle. They all have working defaults; see the Settings Reference in the Astro Live Stacking guide.

The configuration file is stored at ~/.config/pipiece-ui/pipiece.env on the Pi.