Pushbullet: Unterschied zwischen den Versionen
Krikan (Diskussion | Beiträge) K (Modultyp korrigiert) |
(Ersetzung von Forum-Links mit Vorlage Link2Forum) |
||
(13 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt) | |||
Zeile 2: | Zeile 2: | ||
{{Infobox Modul | {{Infobox Modul | ||
|ModPurpose=Senden von Push-Nachrichten an unterschiedliche Endgeräte | |ModPurpose=Senden von Push-Nachrichten an unterschiedliche Endgeräte | ||
|ModType= | |ModType=d | ||
|ModForumArea=Unterstützende Dienste | |ModForumArea=Unterstützende Dienste | ||
|ModTechName=70_Pushbullet.pm | |ModTechName=70_Pushbullet.pm | ||
|ModOwner=fhainz | |ModOwner=fhainz | ||
}} | }} | ||
Zeile 11: | Zeile 11: | ||
==Installation== | ==Installation== | ||
Zur Benutzung von Pushbullet ist ein Google Account zwingend notwenig. Falls noch kein Google Account vorhanden ist kann man diesen [https://accounts.google.com/SignUp hier einrichten]. Anschließend kann man sich auf [http://pushbullet.com pushbullet.com] mit den Google Benutzerdaten einloggen. Den benötigten accessToken findet man in den Account Settings (rechts oben auf das Benutzer-Symbol klicken). | |||
Auf dem | Auf dem gewünschten Endgerät muss nur noch der entsprechende Client installiert werden. | ||
===Offizielle Clients=== | |||
'''Smartphones''' | |||
*iOS: [https://www.pushbullet.com/apps Pushbullet App] | |||
*Android: [https://www.pushbullet.com/apps Pushbullet App] | |||
==Einbinden des Dienstes in | '''Browser-Erweiterungen''' | ||
*Firefox: [https://www.pushbullet.com/apps Pushbullet Plugin] | |||
*Chrome: [https://www.pushbullet.com/apps Pushbullet Plugin] | |||
*Opera: [https://www.pushbullet.com/apps Pushbullet Plugin] | |||
*Safari: [https://www.pushbullet.com/apps Pushbullet Plugin] | |||
'''Betriebssystem-Erweiterungen''' | |||
*Windows: [https://www.pushbullet.com/apps Pushbullet App] | |||
*Mac OS X: [https://www.pushbullet.com/apps Pushbullet App] | |||
===Clients durch die Community=== | |||
*Blackberry: [https://www.pushbullet.com/apps BlackBullet] | |||
*Windows Phone: [https://www.pushbullet.com/apps PushPin] | |||
*Ubuntu: [https://www.pushbullet.com/apps PB Indicator] | |||
Übersicht aller Clients: [https://www.pushbullet.com/apps] | |||
==Einbinden des Dienstes in FHEM== | |||
Das Modul wird mit dem folgenden Befehl in fhem definiert: | Das Modul wird mit dem folgenden Befehl in fhem definiert: | ||
Zeile 35: | Zeile 52: | ||
Nachricht mit Titel ohne Gerät: | Nachricht mit Titel ohne Gerät: | ||
set <name> message Das ist eine Nachricht | set <name> message Das ist eine Nachricht | Ein Titel | ||
Nachricht mit Titel an Gerät iPhone: | Nachricht mit Titel an Gerät iPhone: | ||
set <name> message Das ist eine Nachricht | Ein Titel | iPhone | set <name> message Das ist eine Nachricht | Ein Titel | iPhone | ||
Nachricht mit Titel an Kontakt Max Mustermann | |||
set <name> message Das ist eine Nachricht | Ein Titel | Max Mustermann | set <name> message Das ist eine Nachricht | Ein Titel | Max Mustermann | ||
Wenn kein Titel angegeben wird tritt das Attribut defaultTitel in Kraft. Falls dies nicht gesetzt ist wird der Titel auf FHEM gesetzt. | Wenn kein Titel angegeben wird tritt das Attribut defaultTitel in Kraft. Falls dies nicht gesetzt ist wird der Titel auf FHEM gesetzt. | ||
Zeile 81: | Zeile 98: | ||
*Wenn kein Device angeben wird tritt das Attribut defaultDevice in Kraft. Falls dies nicht gesetzt ist geht der Push an alle '''deine''' Devices. Kontakte erhalten die Benachrichtigung '''nicht!''' | *Wenn kein Device angeben wird tritt das Attribut defaultDevice in Kraft. Falls dies nicht gesetzt ist geht der Push an alle '''deine''' Devices. Kontakte erhalten die Benachrichtigung '''nicht!''' | ||
===Bilder versenden=== | |||
Das geht über ein (von User stkr002 erstelltes) externes Skript, das im Bedarfsfall aus FHEM aufgerufen werden muss: | |||
<pre>#!/usr/bin/perl -w | |||
use WWW::PushBullet; | |||
$KEY = 'XXXXXXXXXXXXXXXXXXXXXXX'; | |||
$pb = WWW::PushBullet->new({apikey => $KEY}); | |||
$filename = '/opt/fhem/snapshot/ipcam_snapshot.jpg'; | |||
$pb->push_file({ file_name => $filename});</pre> | |||
Aufrufen kann man das Skript z.B. über Perl-Code aus FHEM: | |||
my $befehl = "/home/user/script"; | |||
my $ausgabe = `$befehl`; | |||
Wenn man keinen festen Dateinamen und Key verwenden möchte, sondern unterschiedliche Dateien an unterschiedliche Empfänger schicken möchte, muss das oben gepostete Skript die Auswertung von Kommandozeilenparametern mit eingebaut werden: | |||
my $argument = shift @ARGV; | |||
my $noch_ein_argument = shift @ARGV; | |||
etc. | |||
==Kontakt hinzufügen== | ==Kontakt hinzufügen== | ||
Mit | Mit | ||
set <name> contactAdd <Name> | <email> | set <name> contactAdd <Name> | <email> | ||
wird eine neuer Kontakt hinzugefügt. Dieser bekommt erstmal eine | wird eine neuer Kontakt hinzugefügt. Dieser bekommt erstmal eine E-Mail mit einer Einladung zur Pushbullet App. Fall die App nicht installiert wird, bekommt der Kontakt Push-Benachrichtigungen als E-Mail zugestellt. | ||
Zeile 106: | Zeile 143: | ||
==Pushbullet Website== | ==Pushbullet Website== | ||
Die Pushbullet Website | Die Pushbullet Website bietet umfangreiche Möglichkeiten die gesendeten Push Nachrichten, Geräte und Kontakte zu verwalten. Weiters kann man auch Nachrichten versenden und löschen. | ||
==Bekannte Probleme== | |||
===Cannot load module Pushbullet=== | |||
Bei einigen Installationen kommt es beim Start zu folgender Fehlermeldung: | |||
<pre>Error messages while initializing FHEM: | |||
configfile: Cannot load module Pushbullet | |||
Cannot load module Pushbullet</pre> | |||
Abhilfe schafft in der Regel, JSON zu installieren. Zum Beispiel auf dem Raspberry: | |||
<pre>sudo apt-get install libjson-perl</pre> | |||
===Nachrichten von fhem werden nicht verschickt=== | |||
Nachrichten von http://www.pushbullet.com/ kommen jedoch auf dem Telephon an. Sicherstellen, daß das perl IO:Socket:SSL Modul installiert ist: | |||
<pre>sudo apt-get install libio-socket-ssl-perl</pre> | |||
==Links== | ==Links== | ||
*Thread über das Modul im | *Thread über das Modul im {{Link2Forum|Topic=29796|LinkText=FHEM-Forum}} | ||
*Pushbullet [https://www.pushbullet.com/apps Apps] | *Pushbullet [https://www.pushbullet.com/apps Apps] | ||
*Pushbullet [https://docs.pushbullet.com API] | *Pushbullet [https://docs.pushbullet.com API] | ||
*Homepage: [http:// | *Homepage: [http://pushbullet.com pushbullet.com] | ||
[[Kategorie: | [[Kategorie: Code Snippets]] |
Aktuelle Version vom 19. März 2017, 20:32 Uhr
Pushbullet ist ein Dienst, um Benachrichtigungen an unterschiedliche Endgeräte zu senden. Pushbullet stellt Apps für iPhone, Android, Windows (Beta), Mac OS X (bald erhältlich) sowie Plugins für Chrome und Firefox an. Eine genaue Liste kann hier eingesehen werden. Der Dienst sowie die Apps sind kostenlos.
Pushbullet | |
---|---|
Zweck / Funktion | |
Senden von Push-Nachrichten an unterschiedliche Endgeräte | |
Allgemein | |
Typ | Gerätemodul |
Details | |
Dokumentation | EN / DE |
Support (Forum) | Unterstützende Dienste |
Modulname | 70_Pushbullet.pm |
Ersteller | fhainz |
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! |
Installation
Zur Benutzung von Pushbullet ist ein Google Account zwingend notwenig. Falls noch kein Google Account vorhanden ist kann man diesen hier einrichten. Anschließend kann man sich auf pushbullet.com mit den Google Benutzerdaten einloggen. Den benötigten accessToken findet man in den Account Settings (rechts oben auf das Benutzer-Symbol klicken). Auf dem gewünschten Endgerät muss nur noch der entsprechende Client installiert werden.
Offizielle Clients
Smartphones
- iOS: Pushbullet App
- Android: Pushbullet App
Browser-Erweiterungen
- Firefox: Pushbullet Plugin
- Chrome: Pushbullet Plugin
- Opera: Pushbullet Plugin
- Safari: Pushbullet Plugin
Betriebssystem-Erweiterungen
- Windows: Pushbullet App
- Mac OS X: Pushbullet App
Clients durch die Community
- Blackberry: BlackBullet
- Windows Phone: PushPin
- Ubuntu: PB Indicator
Übersicht aller Clients: [1]
Einbinden des Dienstes in FHEM
Das Modul wird mit dem folgenden Befehl in fhem definiert:
define <name> Pushbullet <accessToken>
Push Benachrichtigung senden
Nachricht
Nachricht ohne Titel oder Gerät:
set <name> message Das ist eine Nachricht
Nachricht mit Titel ohne Gerät:
set <name> message Das ist eine Nachricht | Ein Titel
Nachricht mit Titel an Gerät iPhone:
set <name> message Das ist eine Nachricht | Ein Titel | iPhone
Nachricht mit Titel an Kontakt Max Mustermann
set <name> message Das ist eine Nachricht | Ein Titel | Max Mustermann
Wenn kein Titel angegeben wird tritt das Attribut defaultTitel in Kraft. Falls dies nicht gesetzt ist wird der Titel auf FHEM gesetzt. Wenn kein Device angeben wird tritt das Attribut defaultDevice in Kraft. Falls dies nicht gesetzt ist geht der Push an alle deine Devices. Kontakte erhalten die Benachrichtigung nicht!
Link
Der Inhalt des Links wird in der App direkt angezeigt. Ein Webcam Foto kann somit mit einem Touch direkt am Endgerät angezeigt werden.
Link ohne Titel oder Gerät:
set <name> link http://google.com
Link mit Titel ohne Gerät:
set <name> link http://google.com | Google
Link mit Titel an Gerät iPhone
set <name> link http://google.com | Google | iPhone
Link mit Titel an Kontakt Max Mustermann
set <name> link http://google.com | Google | MaxMustermann
- Wenn kein Titel angegeben wird tritt das Attribut defaultTitel in Kraft. Falls dies nicht gesetzt ist wird der Titel auf FHEM gesetzt.
- Wenn kein Device angeben wird tritt das Attribut defaultDevice in Kraft. Falls dies nicht gesetzt ist geht der Push an alle deine Devices. Kontakte erhalten die Benachrichtigung nicht!
Liste
Liste ohne Titel oder Gerät:
set <name> list Milch, Brot, Zucker
Liste mit Titel ohne Gerät:
set <name> list Milch, Brot, Zucker | Einkaufsliste
Liste mit Titel an Gerät iPhone
set <name> list Milch, Brot, Zucker | Einkaufsliste | iPhone
Liste mit Titel an Kontakt Max Mustermann
set <name> list Milch, Brot, Zucker | Einkaufsliste | MaxMustermann
- Wenn kein Titel angegeben wird tritt das Attribut defaultTitel in Kraft. Falls dies nicht gesetzt ist wird der Titel auf FHEM gesetzt.
- Wenn kein Device angeben wird tritt das Attribut defaultDevice in Kraft. Falls dies nicht gesetzt ist geht der Push an alle deine Devices. Kontakte erhalten die Benachrichtigung nicht!
Bilder versenden
Das geht über ein (von User stkr002 erstelltes) externes Skript, das im Bedarfsfall aus FHEM aufgerufen werden muss:
#!/usr/bin/perl -w use WWW::PushBullet; $KEY = 'XXXXXXXXXXXXXXXXXXXXXXX'; $pb = WWW::PushBullet->new({apikey => $KEY}); $filename = '/opt/fhem/snapshot/ipcam_snapshot.jpg'; $pb->push_file({ file_name => $filename});
Aufrufen kann man das Skript z.B. über Perl-Code aus FHEM:
my $befehl = "/home/user/script"; my $ausgabe = `$befehl`;
Wenn man keinen festen Dateinamen und Key verwenden möchte, sondern unterschiedliche Dateien an unterschiedliche Empfänger schicken möchte, muss das oben gepostete Skript die Auswertung von Kommandozeilenparametern mit eingebaut werden:
my $argument = shift @ARGV; my $noch_ein_argument = shift @ARGV;
etc.
Kontakt hinzufügen
Mit
set <name> contactAdd <Name> | <email>
wird eine neuer Kontakt hinzugefügt. Dieser bekommt erstmal eine E-Mail mit einer Einladung zur Pushbullet App. Fall die App nicht installiert wird, bekommt der Kontakt Push-Benachrichtigungen als E-Mail zugestellt.
Gerät / Kontakt umbenennen
Mit
set <name> deviceRename <alterName> | <neuerName>
wird ein Gerät oder Kontakt umbenannt.
Gerät / Kontakt löschen
Mit
set <name> deviceDelete <name>
wird ein Gerät oder Kontakt gelöscht.
Geräte / Kontakte neu einlesen
Mit
get <name> devices
kann man die Device Liste von pushbullet.com neu einlesen.
Pushbullet Website
Die Pushbullet Website bietet umfangreiche Möglichkeiten die gesendeten Push Nachrichten, Geräte und Kontakte zu verwalten. Weiters kann man auch Nachrichten versenden und löschen.
Bekannte Probleme
Cannot load module Pushbullet
Bei einigen Installationen kommt es beim Start zu folgender Fehlermeldung:
Error messages while initializing FHEM: configfile: Cannot load module Pushbullet Cannot load module Pushbullet
Abhilfe schafft in der Regel, JSON zu installieren. Zum Beispiel auf dem Raspberry:
sudo apt-get install libjson-perl
Nachrichten von fhem werden nicht verschickt
Nachrichten von http://www.pushbullet.com/ kommen jedoch auf dem Telephon an. Sicherstellen, daß das perl IO:Socket:SSL Modul installiert ist:
sudo apt-get install libio-socket-ssl-perl
Links
- Thread über das Modul im FHEM-Forum
- Pushbullet Apps
- Pushbullet API
- Homepage: pushbullet.com