Settings

The Settings app (/apps/settings/) provides a comprehensive control panel for user preferences and system administration.

User Pages

Profil

• Display name — Change your visible name
• Avatar color — Pick a custom avatar color
• Password change — Update your login password
• Two-Factor Authentication (2FA) — Enable/disable TOTP-based 2FA with QR code setup, backup codes
• Timezone — Select your timezone (21 common zones) for time display across all apps
• Data export — Download all your data as JSON (profile, notes, finance, documents, places, routines, file list)
• Language — Choose interface language (Deutsch, English)
• Notifications — Configure email, desktop, and sound notification preferences

Aurora KI

• AI Model configuration — Set up Chat, Coding, and Vision models (admin only)
• Provider selection — Local (LM Studio), Anthropic, OpenAI, Google Gemini
• System Integration — Assign models for chat, system, vision, and agent roles
• Read-only fuer Benutzer — Nicht-Admin-Benutzer sehen das aktive KI-Modell und alle Zuweisungen (read-only) v4.1.2
• Freundliche Modellnamen — Rohe Modell-IDs werden als leserliche Namen angezeigt (z.B. "Qwen 3.5 35B") v4.1.2

Darstellung (Appearance) v3.9.1

• Design-Modus — Switch between Dark and Light mode. Changes preview live on the desktop before saving.
• Wallpaper — Choose from 9 built-in gradients (with light/dark variants) or upload custom images (JPG, PNG, WebP, GIF, max 5 per user)
• Bing Daily Images — Browse 8 curated landscape images from Bing. Click to apply as wallpaper. Click "Bilder laden" to refresh.
• Random Daily Wallpaper — Toggle "Taeglich zufaelliges Hintergrundbild" to automatically set a new Bing image each day. Feedback shown on toggle.
• Accent Color — Customize the UI accent color (hex format, e.g. #5a4adf)
• Dock Position — Place the dock at the bottom, left, or right of the screen
• Aurora Chat Mode — Default display mode for the Aurora chat (sidebar, floating window, or split view)
• Aurora Orb Groesse — Slider fuer die Orb-Groesse (36-80px), geraeteuebergreifend synchronisiert v4.1.2
• Aurora Orb Position — Dropdown fuer Orb-Position (4 Ecken: unten-rechts, unten-links, oben-rechts, oben-links) v4.1.2

Speicher (Storage)

• Quota overview — See used vs. available storage
• Storage breakdown — Usage by category (files, apps, shared, cache)

Geraete (Devices & Sessions)

• Active Sessions — View all active PHP sessions for your account
• Revoke sessions — End individual sessions or all other sessions at once
• API Tokens — Manage connected Sync API devices (desktop clients, mobile)
• Revoke tokens — Disconnect individual devices

Ueber (About)

• Version info — Current Niuton version, server details
• System status — Uptime, PHP version, database info

Admin Pages

Admin pages are only visible to users with is_admin = true.

Benutzer (Users)

• User list — All registered users with role, KI provider, last login
• Quota management — Edit storage quota per user (in MB)
• Role toggle — Promote/demote users between Admin and Benutzer
• Delete users — Remove user accounts
• Invite codes — Create single-use invite codes for registration

Einladungen (Invitations)

• Invite management — Create, view, and delete invitation codes

System

• Audit log — View recent system events
• MOTD (Message of the Day) — Set a message shown on the desktop

Konfiguration (Configuration)

33 configurable system settings organized in sections:

Section	Settings
Registrierung & Zugang	Registration mode (open/invite/closed), max users, default quota, session timeout, maintenance mode + message
KI-Verwaltung	API keys (Anthropic/OpenAI/Gemini), LM Studio URL, token budget/day
Apps & Features	Team Chat toggle, registration toggle, per-app enable/disable, room quota (MB), Sync API toggle
MOTD	Message of the Day text
E-Mail / SMTP	SMTP host, port, encryption (STARTTLS/SSL/none), username, password, sender email, sender name
Sicherheit	Min password length, max login attempts, lockout duration
Branding	App name, default theme, default wallpaper, accent color, max upload size

v3.12 Updates v3.12

SMTP Test-Email

Admins koennen jetzt eine Test-Email senden um die SMTP-Konfiguration zu pruefen:

• Test-Button — In der SMTP-Sektion der Konfiguration
• Sofortiges Feedback — Erfolg oder Fehlermeldung mit Details
• Empfaenger — Die Test-Mail geht an die Admin-E-Mail-Adresse

v4.1.2 Updates v4.1.2

Mobile & Responsive

• Hamburger-Navigation — Settings-Sidebar ist jetzt auf mobilen Geraeten und in kleinen Fenstern erreichbar (z-index Fix)
• Formular-Layout — Alle Eingabefelder stapeln sich auf schmalen Bildschirmen vertikal
• Navigation-Padding — Sidebar-Labels werden nicht mehr von der Topbar abgeschnitten, aria-label fuer den Hamburger-Button

Aurora Orb Einstellungen

• Orb-Groesse und -Position sind jetzt in der Datenbank gespeichert statt nur im localStorage
• Einstellungen synchronisieren sich geraeteuebergreifend

Bugfixes

• Geraete-Seite — Sessions-API Permission-Fix
• Versionsnummer — Korrektur von 4.2 auf 4.1 in der Ueber-Seite

Architecture

Settings is a single-file PHP app (apps/settings/index.php, ~3220 lines) with:

• CSRF protection via token validation on all POST requests
• IIFE-scoped JavaScript to avoid global namespace pollution
• 39+ API endpoints via ?api=ACTION pattern
• Admin endpoints protected by is_admin check
• Custom wallpaper uploads stored in userdata/user_{id}/wallpapers/