Package: hallo-eltern-cli
hallo-eltern-clihallo-eltern-cliis a command-line/Python/email interface forEducation Group GmbH's
"Hallo!Eltern" application
for Upper-Austrian schools.hallo-eltern-cliis not affiliated with Education Group GmbH or their
"Hallo!Eltern" application in any way. The "Hallo!Eltern" application is a
product of the Education Group GmbH.hallo-eltern-cliallows to list, messages, read them, download
attachments, etc directly from your Linux terminal and allows to get
full messages including attachments directly to your local inbox.Table of ContentsInstallationCLI CommandsEmail IntegrationEmail server (SMTP)Mail Delivery Agent (MDA)InstallationYou need Python>=3.7Install the package:pip3 install hallo-eltern-cliSet the credentials from your "Hallo!Eltern" application:hallo-eltern-cli config --email YOUR-EMAIL@EXAMPLE.ORG --password YOUR-PASSWORDDone \o/hallo-eltern-cliis now ready for use. For example to list messages,
use thelistcommand:hallo-eltern-cli list
[...]

Flags |   Id    | Subject
---------------------------------------------------
 CC   | 1234567 | Wandertag am Donnerstag
 CC   | 3456789 | Schikurs Anmeldung
  C   | 2345678 | Fehlendes ArbeitsblattCLI commandsThe CLI offers the following commands:listlists available messagesshowshows a messageopenmarks a message as openclosemarks a message as closedconfigupdates and dumps the configurationtesttests the configured user againts the APImdafeeds messages into a message delivery agend (procmail, maildrop, ...)stdoutdumps messages to stdoutsmtpsends messages as emailsversionprints the version numberEmail integrationSimple ways to integratehallo-eltern-cliwith your email pipelines
are to eitherforward the messages to an email server (SMTP)(e.g.: gmx, office365, local server), or topipe the messages to a message delivery agent
(MDA)(e.g.:procmail,maildrop).Email server (SMTP)Thesmtpmode ofhallo-eltern-cliallows to send the messages
(containing the full message's text and attachments) to an email
server to get them to your usual email inbox.To run check for new messages and forward them to your inbox for
example 12 minutes into every hour, simply add a crontab entry like:12 * * * * /path/to/hallo-eltern-cli smtp --force-address your-email-address@example.organd configure the email server to use in$HOME/.config/hallo-eltern-cli/configLocal SMTP serverThe default configuration ofhallo-eltern-cliis to submit to a
local SMTP server throughlocalhost:25. So you do not need to add
any configuration.GMXTo submit the messages to your GMX inbox, set the[smtp]section
in your$HOME/.config/hallo-eltern-cli/configto:[smtp]
host = mail.gmx.net
port = 587
starttls = True
user = your-email-address@gmx.at
password = your-secret-password(Note that the password gets stored in plain text, so secure your
config file through external means)Office365 / HotmailTo submit the messages to your Office365 or Hotmail inbox, set the[smtp]section in your$HOME/.config/hallo-eltern-cli/configto:[smtp]
host = smtp.office365.com
port = 587
starttls = True
user = your-email-address@hotmail.com
password = your-secret-password(Note that the password gets stored in plain text, so secure your
config file through external means)Mail Delivery Agent (MDA)Themdamode ofhallo-eltern-cliallows to format messages as
emails (containing the full message's text and attachments) and submit
them to a mail delivery agent (MDA, e.g.procmail). To run it for
example 12 minutes into every hour, simply add a crontab entry like:12 * * * * /path/to/hallo-eltern-cli mda