Pushbullet: Unterschied zwischen den Versionen

Aus FHEMWiki
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=x
|ModType=d
|ModForumArea=Unterstützende Dienste
|ModForumArea=Unterstützende Dienste
|ModTechName=70_Pushbullet.pm (noch nicht eingecheckt)
|ModTechName=70_Pushbullet.pm
|ModOwner=fhainz
|ModOwner=fhainz
}}  
}}  
Zeile 11: Zeile 11:
==Installation==
==Installation==


Es muss zwingend ein Google Account vorhanden sein. Anschließend kann man sich [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).  
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 gewünschtem Endgerät muss nur noch die entsprechende Applikation installiert werden.
Auf dem gewünschten Endgerät muss nur noch der entsprechende Client installiert werden.


*Apple Geräte: [https://itunes.apple.com/us/app/pushbullet/id810352052 Pushbullet App]
===Offizielle Clients===
*Android Gräte: [https://play.google.com/store/apps/details?id=com.pushbullet.android&hl=de Pushbullet App]
*Chrome: [https://chrome.google.com/webstore/detail/pushbullet/chlffgpmiacpedhhbkiomidkjlcfhogd Pushbullet Plugin]
*Firefox: [https://addons.mozilla.org/de/firefox/addon/pushbullet Pushbullet Plugin]


'''Smartphones'''
*iOS: [https://www.pushbullet.com/apps Pushbullet App]
*Android: [https://www.pushbullet.com/apps Pushbullet App]


==Einbinden des Dienstes in Fhem==
'''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
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 Email mit einer Einladung zur Pushbullet App. Fall die App nicht installiert wird, bekommt der Kontakt Push Benachrichtigungen als Email zugestellt.
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 biete umfangreiche Möglichkeiten die gesendet Push Nachrichten, Geräte und Kontakte zu verwalten. Weiters kann man auch Nachrichten versenden und löschen.
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 [http://forum.fhem.de/index.php/topic,25615.0.html FHEM-Forum]
*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://pushpullet.com pushbullet.com]
*Homepage: [http://pushbullet.com pushbullet.com]


[[Kategorie: Gerätemodul | Code Snippets]]
[[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

Browser-Erweiterungen

Betriebssystem-Erweiterungen

Clients durch die Community

Ü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