https://github.com/dominiczedler/snips-einkaufsliste
Manage a shoppinglist with your voice :memo:
https://github.com/dominiczedler/snips-einkaufsliste
shoppinglist snips snips-app snips-skill voice-control
Last synced: about 2 months ago
JSON representation
Manage a shoppinglist with your voice :memo:
- Host: GitHub
- URL: https://github.com/dominiczedler/snips-einkaufsliste
- Owner: dominiczedler
- Created: 2018-05-22T16:58:54.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-10-30T20:36:38.000Z (over 6 years ago)
- Last Synced: 2025-07-19T05:22:28.529Z (11 months ago)
- Topics: shoppinglist, snips, snips-app, snips-skill, voice-control
- Language: Python
- Homepage:
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Snips-Einkaufsliste :memo:
With this app for [Snips.ai](https://snips.ai/) you can manage a shoppinglist with your voice.
##### Table of Contents
[Features](#i-features)
[Installation](#ii-installation)
[Configuration](#iii-configuration)
[Usage](#iv-usage)
[Troubleshooting](#v-troubleshooting)
[Contribution](#vi-contribution)
## I. Features
- Ability to send the shoppinglist to an email address :postal_horn:
## II. Installation
:exclamation: The following instructions assume that [Snips](https://snips.gitbook.io/documentation/snips-basics) is
already configured and running on your device (e.g. a Raspberry Pi 3 from the
[Snips Maker Kit](https://www.seeedstudio.com/snips.html) with
[Raspbian](https://www.raspberrypi.org/downloads/raspbian/) Stretch Lite).
[SAM](https://snips.gitbook.io/getting-started/installation) should
also already be set up and connected to your device and your account.
1. In the German [app store](https://console.snips.ai/) add the
app `Einkaufsliste` (by domi; [this](https://console.snips.ai/store/de/skill_Va52B5v45GB)) to
your *German* assistant.
2. If you already have the same assistant on your platform, update it with:
```bash
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):
```bash
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.
:exclamation: 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](https://github.com/MrJohnZoidberg/Snips-Einkaufsliste/issues/new).
You can also write other ideas for this app. Thank you for your contribution.
Made with :blue_heart: