Snips-Einkaufsliste 📝

With this app for Snips.ai you can manage a shoppinglist with your voice.

Table of Contents

Features
Installation
Configuration
Usage
Troubleshooting
Contribution

I. Features

• Ability to send the shoppinglist to an email address 📯

II. Installation

❗ The following instructions assume that Snips is already configured and running on your device (e.g. a Raspberry Pi 3 from the Snips Maker Kit with Raspbian Stretch Lite). SAM should also already be set up and connected to your device and your account.

1. In the German app store add the app Einkaufsliste (by domi; this) to your German assistant.

2. If you already have the same assistant on your platform, update it with:

   sam update-assistant

   Otherwise install the assistant on the platform with the following command to choose it (if you have multiple assistants in your Snips console):

   sam install assistant

3. With using SAM you will be asked to enter something for the parameter "email_data". Below in the next section you can found the explanation of it.

III. Configuration

You can configure the app so that it is able to send an email containing the shoppinglist to an address.

❗ Never enter credentials into a programm or website unless you know exactly what is happening to it. In this case you can view the source code and see what is done with it. The problem is that I could also simply insert code into the programm, which let it sent the login credentials to me. But this should only be a warning, so that you know what is possible. Be careful with your data!

The value of the parameter "email_data" is a string in form of a python dictionary. Don't worry if you never heard of something like that. Two curly brackets containing five items which are key-value pairs:

• "from": email address from which the shoppinglist will be sent
• "password": password which belongs to the email address - Since I ported this app to Python 3 you can't have a % in your password anymore (I'm still trying to fix this).
• "host": SMTP host, ex.: "mail.gmx.net"
• "port": SMTP port, usually 587
• "to": email address to which the shopping list will be sent

The email address used in "FROM" and "TO" can be the same.

Examples:

{"from": "meinemail@gmx.net", "password": "eb457fg9", "host": "mail.gmx.net", "port": 587, "to": "meinemail@gmx.net"}

{"from": "hello@gmx.com", "password": "bo95345b3v", "host": "mail.gmx.com", "port": 587, "to": "hello@gmx.com"}

Don't forget all the quotation marks and the curly brackets at the beginning and at the end!

With a Google email configuration you have to enable the option called like "allow external apps to send emails".

The content of the config.ini file should look like this:

[secret]
email_data={"from": "meinemail@gmx.net", "password": "eb457fg9", "host":
"mail.gmx.com", "port": 587, "to": "hello@gmx.com"}

IV. Usage

1. Example sentences

Add item:

• Schreibe Tomaten auf meine Einkaufsliste.
• Kannst du bitte Milch auf meiner Einkaufsliste notieren?

Ask for item:

• Ist Essig schon auf der Einkaufsliste?
• Stehen Himbeeren auf meiner Einkaufsliste?

Get items:

• Was steht auf der Einkaufsliste?
• Lese meine Einkaufsliste vor.

Send list:

• Schicke meine Einkaufsliste per Email.
• Ich möchte die Einkaufsliste als Email auf mein Handy haben.

Delete item:

• Entferne Kümmel von der Einkaufsliste.
• Streiche Apfelsaft von der Einkaufsliste weg.
• Ich brauche keinen Zimt mehr.

Delete list:

• Lösche die Einkaufsliste.
• Entferne die gesamte Einkaufsliste.

V. Troubleshooting

• The time in the emails is wrong.

  Make sure that the time and date are correct on your device.

• I cannot see an email in my inbox, but Snips said it has been sent.

  Have a look in your spam folder.

VI. Contribution

Please report errors and bugs (you can see them with sam service log snips-skill-server or on the Pi with sudo tail -f /var/log/syslog) by opening a new issue. You can also write other ideas for this app. Thank you for your contribution.

Made with 💙