ProtonMail CLI
Command line utility for https://protonmail.com
Installation
System dependencies (Probably everything's already installed)
sudo apt install -y xvfb python3-pip firefox # on debian
sudo dnf install xorg-x11-server-Xvfb python3-pip firefox # on fedora
sudo pacman -S xorg-server-xvfb python-pip firefox wget # on archGeckodriver
# Find your release: https://github.com/mozilla/geckodriver/releases
# for linux x64
wget https://github.com/mozilla/geckodriver/releases/download/v0.26.0/geckodriver-v0.26.0-linux64.tar.gz
sudo tar -xvf geckodriver-*.tar.gz -C /usr/local/bin/ ; rm geckodriver-*.tar.gzProtonmail CLI
git clone https://github.com/dimkouv/protonmail-cli /opt/protonmail-cli
ln -s /opt/protonmail-cli/protonmail-cli.py /bin/protonmail-cli
pip3 install -r /opt/protonmail-cli/requirements.pipUsage
Use as a command line
# show full usage
protonmail-cli --help
# each sub-command has its own `--help` section.
# list inbox - print latest mails
protonmail-cli list -t inbox
protonmail-cli list -t spam
# check inbox for new mails
protonmail-cli check
# send mail
protonmail-cli send \
-t "[email protected]" \
-t "[email protected]" \
-s "my subject" \
-b "my mail message" \
--html # (optional if you want to render body as html) \
-a "/path/to/file.jpg" \ # (optional for adding attachments)
-a "/path/to/other/file.pdf"Global settings, including user credentials, can be specified on /opt/protonmail-cli/protonmail/settings.py
User credentials can also be set in their own file, overriding those found inside
settings.py. The global argument --credential allow you to set the file path of
this config file. This would allow better security by allowing each user of a multi-users
machine to keep their credentials inside their home folder.
If user credentials are not specified in settings.py or credentials file then cli prompts you to type them.
Example usage of separate credentials file
# /home/user/protonmailcli.ini
[credential]
username = [email protected]
password = mysafepassprotonmail-cli --credential /home/user/protonmailcli.ini list For even better security, chmod 600 this file, so only the user launching the
application can read it.
Run in an interactive session
Simply run protonmail-cli without any parameters to open an interactive session.
[Anonymous] Choose an option from the menu
m : Shows this menu
x : Exit
l : Login
> l
ProtonMail email or username: dimkouv
ProtonMail password:
Loading...
Welcome dimkouv
[dimkouv] Choose an option from the menu
m : Shows this menu
x : Exit
e : Logout
inbox : Show inbox mails
drafts : Show drafts
sent : Show sent mails
starred : Show starred mails
archive : Show archived mails
spam : Show spam mails
trash : Show trash mails
allmail : Show all mails
>Use as a package
Core functions can be called directly from your code instead of using protonmail-cli
pip3 install git+https://github.com/dimkouv/protonmail-cliUsage example
import protonmail
client = protonmail.core.ProtonmailClient()
client.login("[email protected]", "mypassword")
# send mails
client.send_mail(
["[email protected]", "[email protected]"],
"subject",
"my mail message"
)
# send mails as html
client.send_mail(
["[email protected]", "[email protected]"],
"subject",
"""
<h1>hello friend</h1>
<p>This message was sent from <strong>protonmail-cli</strong></p>
""",
as_html=True
)
# upload attachments
client.send_mail(
...,
attachments=[
'/path/to/file.jpg',
'/path/to/other/file.pdf'
]
)
# read mails
mails = client.get_mails("inbox")
spam = client.get_mails("spam")
# check for new mail
has_new_mail = client.has_new_mail()
client.destroy()Testing
cd protonmail-cli
virtualenv -p python3 venv
source venv/bin/activate
pip install .
python3 tests/core_test.py