Differences

This shows you the differences between two versions of the page.

--- skripting-section:div-skripts:energy-air-selenium-bot [2019/08/23 15:56] – [Bot ausführen] michael
+++ skripting-section:div-skripts:energy-air-selenium-bot [2019/08/27 14:40] (current) – [Energy Air Selenium-Bot] michael
@@ Line 4: / Line 4: @@
 Das Script ist in Python3 geschrieben und wurde mit [[https://www.python.org/ftp/python/3.7.4/python-3.7.4.exe|Python 3.7.4]] getestet.
+<WRAP left round alert 70%>
+''**ACHTUNG**: BITTE BOT NICHT INS INTERNET HOCHLADEN ODER AN DRITTE WEITERGEBEN! - merci''
+</WRAP>
+<WRAP clear/>
@@ Line 10: / Line 17: @@
 Als Beispiel Installation, wird das Verzeichnis ''D:\EnergyAir-Bot-2019\'' auf einem Windows 8.1 System verwendet. Zum erstmaligen einrichten, wird das Kapitel "Vorbereitung und Installation" gebraucht. Für jeden weiteren Start des Bots, kann anschliessend wie im Kapitel "Bot ausführen" beschrieben vorgegangen werden.
+<WRAP center box 100%>
 ==== Vorbereitung und Installation ====
-  - Installation vom **Python 3.7.4** - ''**Wichtig**: Während der Installation gilt es zu beachten, dass der Haken unter "**Add Python 3.7 to PATH**" gesetzt ist.''
+Für das erstmalige Setup und das Ausführen des Energy Air Botes, sind initial vier Vorberitungschritte nötig.
+=== Vorbereitung 1 - Gmail Account API aktivieren und Label vorbereiten ===
+  - Klicke auf [[https://developers.google.com/gmail/api/quickstart/python|Enable The GMAIL API]] und "Download Client Config"
+  - In der Gmail Inbox [[https://mail.google.com/|mail.google.com]]] ein neues ''Label'' namens "''Energy''" kreieren.
+  - Unter Einstellungen (oben rechts), zu "Filter & blockierte Adressen gehen und "Neuen Filter erstellen" klicken.
+  - Bei ''von:'' die Email Adresse ''no-reply-smsforwarder@cofp.ru'' eintragen
+  - Filter erstellen und auf das neu erstellte Label "Energy" anwenden.
+----
+=== Vorbereitung 2 - Smartphone SMS to Email App einrichten ===
+  - Android App Installieren [[https://play.google.com/store/apps/details?id=com.gawk.smsforwarder|
+SMS an Mail / Telefon - automatische Umleitung]]
+  - Die App so konfigurieren, dass die Energy Nachrichten (SMS) an das vorher konfigurierte Gmail-Konto weitergeleitet werden.
+  - **Achtung**: Die App muss im Hintergrund offen bleiben, demnach die App nicht aus den "offenen Apps" löschen. (<wrap em>Evtl. Energieplan auf dem Handy anpassen.</wrap>)
+<WRAP center round info 100%>
+//<wrap em>iPhone App (optional)</wrap>//
+  * Falls kein Android Smartphone vorhanden ist, kann ein entsprechendes App aus dem Appstore genutzt werden, welches SMS auf Mail umleitet. Die Regex um den Code im String zu finden muss dann jedoch entsprechend im gmail_nrg_code.py Script angepasst werden.\
+  * Mögliche App: [[https://apps.apple.com/ch/app/mysms-mirror-sms-weiterleiten/id681057282|SMS Weiterleiten]]
+</WRAP>
+----
+=== Vorbereitung 3 - Einrichten des Bot Workspaces: ===
+  - Installation vom **Python 3.7.4** - ''Während der Installation gilt es zu beachten, dass der Haken "**Add Python 3.7 to PATH**" gesetzt ist!''
+  - Energy Air Bot {{ :skripting-section:div-skripts:energyair-bot-2019.zip |herunterladen}} und in das Verzeichnis ''D:\EnergyAir-Bot-2019\'' entpacken.
+  - Neues unprivilegiertes **CMD-Fenster** öffnen und in den Projekt Ordner navigieren: (Win + R || "CMD" eintippen || ENTER) <code># d:
+# cd EnergyAir-Bot-2019</code>
+  - Hier wird nun ein virtualenv für Python installiert: <code># pip3 install virtualenv
+# virtualenv venv</code>
+  - Nach dem erfolgreichen vorbereiten des virtualenvs, muss dieses für das aktuelle CMD-Fenster aktiviert werden, um dann auch gleich die noch benötigten Python requirements darin zu installieren. <code># venv\Scripts\activate.bat
+# pip install -r requirements.txt</code>
+  - ''CMD-Fenster offen lassen!''
+----
+=== Vorbereitung 4 - Erstmaliges Ausführen des Botes (Zur Berechtigung Gmail + setzen der Label ID) ===
+  - ''credentials.json'' (GMAIL API Auth) in den ''Projektordner (D:\EnergyAir-Bot-2019\)'' platzieren.
+  - Im ''gmail_nrg_code.py'' gibt es zwei Stellen welche mit Uncomment markiert sind. Diese Blöcke müssen für die erste Ausführung komplett einkommentiert werden.
+  - Das Skript mittels <code># energy-sbot2019.py</code> in der CMD-Konsole ausführen.
+  - Die ''id'' des Labels kopieren und an folgender Codestelle einfügen: <sxh python; gutter: false;>results = service.users().messages().list(userId='me', labelIds=['UNREAD', 'Label_YOURLABELID'],</sxh>
+  - Beide Codeblöcke wieder auskommentieren.
+----
+=== Starten des Energy Air Botes ===
+Zum starten des Botes im Bot Verzeichnis "''D:\EnergyAir-Bot-2019\''" und im Aktiven ''venv'' folgenden Befehl ausführen. <WRAP clear/>
+//Anschliessend warten auf den Gewinn.. ;)//
+<code># energy-sbot2019.py</code>
+</WRAP>
+----
 <WRAP center box 100%>
-==== Bot ausführen====
+==== Bot erneut ausführen (nach PC reboot oder für neue Nummer) ====
 ''Neues unprivilegiertes **CMD-Fenster** öffnen und nachfolgende Kommandos eintippen.''
@@ Line 35: / Line 105: @@
 </WRAP>
-----
 ===== Sourcecode des selenium-Bots v2019 =====