wolfgangfahl / pythunderbird

python based access to Thunderbird mail

pyThunderbird

python based access to Thunderbird mail

Demo

Demo

Home page Search Mail display

Installation

pip install pyThunderbird

Get Sources

git clone https://github.com/WolfgangFahl/pyThunderbird
cd pyThunderbird
scripts/install

Testing

scripts/test

Documentation

Wiki

Authors

• Wolfgang Fahl

pythunderbird's Issues

Thundbird profile details display

e.g. user / number of mailboxed / index state with links to mailboxes/search/index (same as tabular view but per profile)

migrate to nicegui

e.g. to implement search frontend for #15

Use https://github.com/WolfgangFahl/nicegui_widgets as a framework

When there are multiple messages with the same id return the first

Currently no message is returned.

Cache mbox table of contents

see python/cpython#112429

make from and to headers clickable to allow replying to mail just displayed

change to a mailto: href

add demo with sample mailboxes

e.g.

• https://raw.githubusercontent.com/catmin/inetsim/master/data/pop3/sample.mbox
• https://github.com/hoffmangroup/segway-mailing-list-archives/tree/master

Allow to display a whole folder based on folder name

e.g. "Belege-2021"

display wikison notation for cut&paste into Semantic MediaWiki

see http://wiki.bitplan.com/index.php/WikiSon

example:

{{mail
|user=wf
|id=[e-mail]
|from=[e-mail]
|to=[e-mail]
|subject=Wikidata Digest, Vol 107, Issue 2
}}

Allow to display wiki markup as "Problem"

{{Problem
|Problem={{mail
|user=
|id=...
}}
|at=2021/12/09
|state=Open
|storemode=property
}}

fix codec issues

'utf-8' codec can't decode byte 0xdf in position 25: invalid continuation byte
Traceback (most recent call last):
File "tb_webserver.py", line 156, in get_mail
mail = Mail(user=user, mailid=mailid, tb=tb, debug=self.debug)
File "mail.py", line 947, in init
self.extract_message()
File "mail.py", line 976, in extract_message
rawPart = part_str.decode(charset)

Folderpath mapping should work on all levels

e.g. mailbox://nobody@Local Folders/WF/Friends/Diverse
should lead to
Mail/Local Folders/WF.sbd/Friends.sbd

fix broken text e.g. Rückmeldung

see https://stackoverflow.com/a/39904411/1497139

check mail id when displaying messages to avoid displaying wrong message

currently the mail lookup is either by gloda or by index_db - if the content of the indexes is not up-todate a wrong
mail might be displayed - avoid this by checking the mailid of the found message

gloda_update time not updated after rsync

I have rsynced my mails to the server but the gloda_update_time stays at the old value.

handle html encoding properly e.g. when displaying mail-id, subjects and the like

Get Message by user and id

given the id of a message (headerMessageID) and a user id retrieve the corresponding Mail

• lookup the profile of the user as outlined in #2
• query the global-messages-db.sqlite for the folder
• retrieve the message

add command line interface

allow to retrieve a message by user and messsage id

if no user list is specified show all mailboxes defined in thunderbird.yaml

update index does not work as expected

ImportError: cannot import name 'Markup' from 'flask'

after running the WebServer by python thunderbird/webserver.py
ImportError: cannot import name 'Markup' from 'flask'

Here are the dependencies:

APScheduler==3.10.4
blinker==1.7.0
Bootstrap-Flask==2.3.2
certifi==2023.11.17
charset-normalizer==3.3.2
click==8.1.7
contourpy==1.2.0
cycler==0.12.1
dicttoxml2==2.1.0
Flask==3.0.0
Flask-Dropzone==1.6.0
Flask-HTTPAuth==4.8.0
Flask-Login==0.6.3
Flask-SQLAlchemy==3.1.1
Flask-WTF==1.2.1
fonttools==4.45.0
ftfy==6.1.3
greenlet==3.0.1
idna==3.4
isodate==0.6.1
itsdangerous==2.1.2
Jinja2==3.1.2
jsonpickle==1.5.2
kiwisolver==1.4.5
MarkupSafe==2.1.3
matplotlib==3.7.4
numpy==1.26.2
packaging==23.2
pandas==2.1.3
Pillow==10.1.0
pydevd==2.10.0
PyDispatcher==2.0.7
pyFlaskBootstrap4==0.6.1
Pygments==2.17.2
pylatexenc==2.10
pyLodStorage==0.4.14
pyparsing==3.1.1
python-dateutil==2.8.2
pyThunderbird @ file:///home/tobias/tmp/pyThunderbird/pyThunderbird
pytz==2023.3.post1
PyYAML==6.0.1
rdflib==7.0.0
requests==2.31.0
six==1.16.0
SPARQLWrapper==1.8.5
SQLAlchemy==2.0.23
SQLAlchemy-Utils==0.41.1
tabulate==0.9.0
typing_extensions==4.8.0
tzdata==2023.3
tzlocal==5.2
urllib3==2.1.0
wcwidth==0.2.12
Werkzeug==3.0.1
WTForms==3.1.1

fix attachment names and other header information

examples:

Subject: | =?ISO-8859-1?Q?agorum=AE_Software?=

3:	application/octet-stream	None	=?UTF-8?Q?=C3=9Cberblick=2Edocx?=(20238)

add restful interface

allow to retrieve a message by user and message id

Given a user id lookup the thunderbird profile

use a yaml file for configuration

#
# Thunderbird profiles mapping 
#
wf:
  db: /Users/wf/backup/global-messages-db.sqlite
  profile: /Users/wf/Library/Thunderbird/Profiles/mxz53xfn.default

guess extension of unnamed parts to make sure e.g. pdf is correctly downloadable

https://stackoverflow.com/a/29675124/1497139

Search through thunderbird mails

What I want to do:
I need a python access to my Thunderbird mails. I want to search for specific contents and mail addresses. The description in the readme suggests that this is the purpose of this package.

What I already did
I tried to access Thunderbird-class. Unfortunately, this class needs a .thunderbird.yaml in the home directory.
I have no idea about the content of this file. Could you provide a template?
Also I do not know which db to pass.
Then, how do I search through the mails?