🚀 Schnellstart (5 Minuten)

1. TimeOffice Kalender aktivieren

• In TimeOffice: Einstellungen → Google Kalender aktivieren
• Dienstplan synchronisieren lassen (dauert ein paar Minuten)
• In CF Alarm: TimeOffice-Kalender auswählen

2. App installieren & erste Anmeldung

• App herunterladen über den bereitgestellten Link
• Bei erstem Start: Google Account auswählen für Calendar-Zugriff
• Berechtigungen gewähren: Kalender und Benachrichtigungen

3. Grundeinstellungen

• Schichttypen prüfen: Wecker-Tab → „Schichttypen verwalten". Jeder Schichttyp hat eine feste Weckzeit (keine Vorlaufzeit-Rechnung) und ein oder mehrere Erkennungsmuster.
• Kürzel zuordnen: Ganz oben zeigt die Karte „Diese Kürzel stehen in deinem Kalender" die Termin-Kürzel deines echten Dienstplans, für die noch kein Muster existiert. Antippen, Schicht wählen – ohne diesen Schritt bleiben Schichten anderer Stationen unerkannt und es klingelt kein Wecker.

✅ Fertig! CF Alarm erstellt automatisch Wecker basierend auf Ihren TimeOffice-Terminen.

⚠️ Häufige Stolperfallen vermeiden

🔋 Batterieoptimierung (WICHTIG!)

• Problem: Android "optimiert" CF Alarm weg → keine Alarme
• Lösung: Android Einstellungen → Apps → CF Alarm → Akku → "Nicht optimieren"
• OnePlus/Xiaomi: Zusätzlich "Autostart" aktivieren
• Test: Mit manuellen Alarm testen

📅 TimeOffice Kalender-Probleme

• Kalender nicht sichtbar? TimeOffice → Google Kalender erst aktivieren, dann 10 Min warten
• Alte Termine? Google Calendar App öffnen → Aktualisieren
• Keine Termine? In Google Calendar prüfen ob TimeOffice-Kalender sichtbar ist

🔔 Benachrichtigungs-Probleme

• Stille Alarme? Android Einstellungen → Apps → CF Alarm → Benachrichtigungen → alle aktivieren
• Nicht-Stören-Modus: Keine Ausnahme nötig – der CF-Alarm-Wecker klingelt auch bei aktivem „Nicht stören", unabhängig von jeder Einstellung.
• Kein Vollbild-Alarm? Android Einstellungen → Apps → CF Alarm → Benachrichtigungen → „Vollbild-Benachrichtigungen" erlauben. Hinweis: Das Vollbild ist für das gesperrte/dunkle Gerät gedacht – benutzt man das Handy gerade aktiv, erscheint bewusst nur ein Banner.

📱 Verschiedene Android-Versionen

• Android 12+: "Exakte Alarme" Berechtigung gewähren
• Samsung: "App im Hintergrund laufen lassen" aktivieren
• Huawei: CF Alarm in "Geschützte Apps" hinzufügen

💡 Philips Hue Setup (Optional)

🌉 Hue Bridge verbinden

• Voraussetzung: Handy und Hue Bridge im gleichen WLAN
• CF Alarm: Hue Tab → "Bridge suchen"
• Bridge-Taste drücken wenn CF Alarm danach fragt
• Automatische Erkennung dauert 10-30 Sekunden

🌅 Licht-Szenarien

Jede Regel setzt das Licht auf genau eine von drei Arten – du wählst sie im Regel-Editor unter „Wie soll das Licht gesetzt werden?“.

• Szene: Eine Szene aus deiner Hue-App („Nachtlicht“, „Entspannen“). Sie bringt Helligkeit und Farbe je Lampe selbst mit – du musst nichts nachbauen. Du wählst erst den Raum, dann die Szene darin, und kannst mehrere Räume kombinieren (pro Raum eine Szene). Szenen ohne Raum oder Zone werden nicht angeboten; ordne sie in der Hue-App einem Raum zu, dann erscheinen sie.
• Manuell: Einzelne Lampen oder Gruppen/Zonen auswählen und Helligkeit und Farbe selbst einstellen.
• Sanftes Aufwachen (Sonnenaufgang): Die Rampe endet standardmäßig zur Weckzeit und startet entsprechend früher – Dauer einstellbar (Vorgabe 15 Minuten). Die Farbtemperatur fährt von warm nach kühler (Vorgabe 2000 K → 4000 K), die Helligkeit bis zum eingestellten Zielwert.

• Auto-Aus: Wird als Zeitplan auf der Bridge selbst angelegt – das Licht geht deshalb auch aus, wenn das Handy inzwischen nicht mehr im Heim-WLAN ist. Bei einer Szene schaltet es den ganzen Raum aus: zu einer Szene gibt es keinen Gegenbefehl.
• Regel testen: Der Knopf im Regel-Editor schaltet sofort und räumt nach ein paar Sekunden wieder auf – auch dann, wenn für die Regel selbst kein Auto-Aus eingestellt ist.

🔧 Hue-Probleme beheben

• Bridge nicht gefunden? WLAN prüfen, Bridge neustarten
• Verbindung verloren? CF Alarm verbindet sich selbst wieder, sobald das Heim-WLAN zurück ist – spätestens beim nächsten Öffnen der App. Manuell geht es über „Erneut versuchen" im Hue-Tab.
• Licht geht nicht an? Hue-Lampen an regulärem Schalter prüfen

🏆 Profi-Tipps

📊 Optimal nutzen

• Konfiguration sichern: Einstellungen-Tab → „Konfiguration" → „Exportieren" legt Schichttypen, Hue-Regeln, Dimmer-Regeln und „Nicht stören" als Datei ab. „Importieren" holt sie zurück – nach einer Neuinstallation oder auf einem neuen Gerät. Anmeldung, Kalenderauswahl und Hue-Bridge-Verbindung sind bewusst nicht in der Datei und werden auf jedem Gerät neu eingerichtet.
• Kürzel zuordnen statt raten: Wecker-Tab → „Schichttypen verwalten". Oben zeigt die Karte „Diese Kürzel stehen in deinem Kalender" die Termin-Kürzel ohne Erkennungsmuster – antippen und der passenden Schicht zuordnen.
• Urlaub: „Automatische Alarme" im Wecker-Tab ausschalten – oder für längere Abwesenheit „Hintergrunddienste pausieren" im Einstellungen-Tab, das pausiert zusätzlich Dimmer, „Nicht stören" und Hue-Automatik.
• Diensttausch: „Manueller Alarm" (Knopf unten rechts im Home-Tab) als Absicherung.

🚨 Notfall-Funktionen

• Nächsten Alarm überspringen: Einen einzelnen Wecker aussetzen, ohne die Automatik abzuschalten (Wecker-Tab). Der Hinweis setzt sich von selbst zurück, sobald der Zeitpunkt vorbei ist.
• Schlummer-Dauer: Im Wecker-Tab wählbar (3/5/10/15 Minuten) – ein Wert, der für den Vollbild- und den Benachrichtigungs-Knopf gleichermaßen gilt. Eine Obergrenze für die Anzahl der Schlummer-Durchgänge gibt es nicht.
• Fallback-Wecker: Zusätzlicher Handy-Wecker zur Sicherheit

💡 Pro-Tipp: CF Alarm läuft am zuverlässigsten wenn Sie die Batterieoptimierung deaktivieren und die App regelmäßig (1x pro Woche) kurz öffnen.

🆘 Wenn etwas nicht funktioniert

🔍 Erste Hilfe

• App neustarten: CF Alarm komplett schließen und neu öffnen
• Berechtigungen prüfen: Android Einstellungen → Apps → CF Alarm
• Google Account: In Google Calendar App an-/abmelden
• TimeOffice: Google Kalender deaktivieren → aktivieren

📞 Support kontaktieren

Problem nicht gelöst? Kontaktieren Sie uns über:

• GitHub Issues: Detaillierten Fehlerbericht erstellen
• Infos bereithalten: Android-Version, Handy-Modell, Fehlerbeschreibung