115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# mms2mail
|
|
|
|
Mail bridge for mmsd.
|
|
|
|
mms2mail:
|
|
* convert incoming mms from mmsd to mail and store it in unix mbox.
|
|
* provide a smtp server converting mail to mms with mmsd.
|
|
|
|
By default:
|
|
* store mails in the current user mbox (```/var/mail/$USER```)
|
|
* in case the mbox is locked by another process the output could be found in ```$HOME/.mms/failsafembox```
|
|
* listen on localhost port 2525 for mail
|
|
|
|
## installation
|
|
|
|
### dependency
|
|
|
|
- python3
|
|
- python3-aiosmtpd
|
|
- python3-pydbus
|
|
|
|
### setup
|
|
|
|
Install the dependency and mms2mail (on debian based distribution):
|
|
```
|
|
make deb-deps install
|
|
```
|
|
For other distribution:
|
|
```
|
|
make pypy-deps install
|
|
```
|
|
|
|
To enable the daemon mode in systemd user :
|
|
```
|
|
make configure start
|
|
```
|
|
|
|
Depending on your distribution, you might have to add your account to the ```mail``` group to be able to lock and use the system mbox.
|
|
On Debian based distribution :
|
|
```
|
|
sudo addgroup $(whoami) mail
|
|
```
|
|
|
|
#### manual install
|
|
|
|
Install the dependency and mms2mail (on debian based distribution):
|
|
```
|
|
sudo apt-get install python3
|
|
sudo apt-get install python3-pydbus
|
|
sudo apt-get install python3-aiosmtpd
|
|
|
|
mkdir -p ~/.local/bin
|
|
cp mms2mail ~/.local/bin
|
|
```
|
|
To enable the daemon mode in systemd user :
|
|
```
|
|
mkdir -p ~/.config/systemd/user
|
|
cp mms2mail.service ~/.config/systemd/user/
|
|
systemctl --user daemon-reload
|
|
systemctl --user enable mms2mail
|
|
systemctl --user start mms2mail
|
|
```
|
|
|
|
Depending on your distribution, you might have to add your account to the ```mail``` group to be able to lock and use the system mbox.
|
|
On Debian based distribution :
|
|
```
|
|
sudo addgroup $(whoami) mail
|
|
```
|
|
|
|
### config
|
|
An optional configuration file can be put in the home folder : ```$HOME/.mms/modemmanager/mms2mail.ini```. The default value are :
|
|
|
|
```
|
|
[mail]
|
|
mailbox = /var/mail/$USER ; the mailbox where mms are appended
|
|
user = $USER ; the user account specified as recipient
|
|
domain = $HOSTNAME ; the domain part appended to phone number and user
|
|
attach_mms = false ; whether to attach the full mms binary file
|
|
delete_from_mmsd = false ; delete mms from mmsd storage upon successful conversion
|
|
|
|
[smtp]
|
|
hostname = localhost
|
|
port = 2525
|
|
```
|
|
|
|
## usage
|
|
|
|
### reference
|
|
```
|
|
mms2mail [-h] [--disable-smtp] [--disable-mms-delivery] [--force-read] [--force-unlock] [-l {critical,error,warning,info,debug}]
|
|
|
|
optional arguments:
|
|
-h, --help show this help message and exit
|
|
--disable-smtp
|
|
--disable-mms-delivery
|
|
--force-read Force conversion even if MMS is marked as read
|
|
--force-unlock BEWARE COULD LEAD TO WHOLE MBOX CORRUPTION Force unlocking the mbox after a few minutes /!\
|
|
-l {critical,error,warning,info,debug}, --logging {critical,error,warning,info,debug}
|
|
Define the logger output level
|
|
```
|
|
|
|
### Sending MMS
|
|
|
|
To send MMS, mail address not in the following format would be ignored :
|
|
```+123456789@domain``` with phone number in international format.
|
|
|
|
#### with Mutt :
|
|
To be able to send mms with mutt you need it to be built with SMTP support.
|
|
And and the following line in your ```$HOME/.muttrc```:
|
|
```
|
|
set smtp_url = "smtp://localhost:2525"
|
|
set ssl_starttls = no
|
|
set ssl_force_tls = no
|
|
|
|
```
|