Admin Settings v{{ version }}

Booth Status

When closed, the public request page shows a "booth closed" message instead of the form.

Booth is currently Open ✅ Closed ❌ Save Booth Status

Database Health

{% if not health.ok %}

❌ {{ health.message }}

{% if health.missing_columns %}

Missing columns: {{ health.missing_columns | join(', ') }}

{% endif %} {% if health.missing_tables %}

Missing tables: {{ health.missing_tables | join(', ') }}

{% endif %}

Fix Database Schema

{% else %}

✅ {{ health.message }}

Recheck / Apply Schema

{% endif %}

Database Statistics

Total requests: {{ total_records }}

Database size: {{ db_size }}

Uploaded MP3s: {{ upload_file_count }} files in {{ upload_dir_count }} request folders

Uploads total size: {{ upload_size }}

{% if status_counts %}

Status breakdown:

{% for status, count in status_counts.items() %}
• {{ status }}: {{ count }}
{% endfor %}

{% endif %}

Database path:
{{ db_path }}

Uploads path:
{{ upload_path }}

Revision Limit

Maximum customer revisions allowed

Set to 0 to disable customer-submitted revisions. Operators can still upload new versions manually.

Save Revision Limit

Dashboard Auto-Refresh

Refresh interval Off 10 seconds 20 seconds 30 seconds Save Refresh Interval

Kiosk Display Mode

Set how the public /kiosk page cycles. Use -1 for QR only, 0 for pricing only, 1 for queue only, or 5+ seconds to cycle between QR, pricing, and queue.

Kiosk cycle seconds

Examples: -1 = QR only, 0 = pricing only, 1 = queue only, 10 = rotate QR → pricing → queue every 10 seconds.

Save Kiosk Mode

Hermes API Key

Set via Portainer env var HERMES_API_KEY. Used for callback auth.

Current key: {{ hermes_key_masked }}

{% if not hermes_key_set %}

⚠️ No Hermes API key is configured. Set the HERMES_API_KEY environment variable in Portainer before using the callback workflow.

{% endif %}

---

Callback Link Expiry

How long the signed Hermes callback URL stays valid (in hours). Default is 168 hours (7 days).

Callback expiry (hours) Save Callback Expiry

ntfy Notifications

Push notifications for new customer requests. Leave either field blank to disable.

ntfy Server URL
ntfy Topic
ntfy Access Token	Required if the topic is access-controlled. Leave blank to keep the existing stored token.

Save ntfy Settings

---

Send Test Notification

Send Test ntfy

MusicGPT Integration

API key is set via the MUSICGPT_API_KEY environment variable in Docker.

API key configured: {{ '✅ Yes' if musicgpt_api_key_set else '❌ No' }}

Webhook URL: {{ musicgpt_webhook_url }}

Register this URL in your MusicGPT account webhook settings so completed songs POST back here.

---

Album Cover Delivery

When enabled, the generated album cover is attached to the delivery email. It is always shown on this admin page.

Attach album cover to delivery email Save Album Cover Setting

Email (SMTP) Settings

These settings are used to send confirmation, preview, and delivery emails to customers. The password is stored encrypted using the Flask secret key.

SMTP Host
SMTP Port
SMTP Username
From Address
SMTP Password

Save Email Settings

---

Send Test Email

Test recipient address Send Test Email

MP3 Metadata Tags

These values are written into every uploaded MP3 file. The song title from the prompt is written to the Title tag automatically. Blank fields are skipped.

Artist
Album
Year
Comment	{{ metadata.get('comment', '') or '' }}

Save Metadata Defaults

Database Backup / Restore

Download a copy of the SQLite database before the event. Upload a previous backup to restore it; the current database will be renamed as a timestamped backup.

Download Database Backup

Restore from backup (.db / .sqlite) Restore Database

Music Files Backup

Download all uploaded MP3 and archived revision files as a single ZIP.

Download Music Files ZIP