dmc

dynamic mail client
git clone git://git.suckless.org/dmc
Log | Files | Refs | README | LICENSE

README (1906B)


      1 dmc - dynamic mail client
      2 =========================
      3 dmc is a minimalist e-mail client solution
      4 
      5 
      6 Requirements
      7 ------------
      8   msmtp to send emails (dmc-smtp is not implemented yet)
      9   openssl to build with SSL support
     10 
     11 
     12 Installation
     13 ------------
     14 Few binaries will be copied into the bin directory
     15 
     16   make all install PREFIX=/usr
     17 
     18 If you want to build dmc without SSL edit config.mk or type:
     19 
     20   make HAVE_SSL=0
     21 
     22 NOTE that default prefix is /usr, not /usr/local
     23 
     24 If you want to install dmc into a chroot, just set the DESTDIR:
     25 
     26   make install DESTDIR=/path/to/my/chroot
     27 
     28 Configuration
     29 -------------
     30 Accounting information is stored in ~/.dmc/acc and can be
     31 edited with
     32 
     33 	dmc -e myaccount
     34 
     35 Type your signature in ~/.dmc/signature
     36 
     37 Configuring msmtp:
     38 ------------------
     39 To be able to send emails you have to properly configure msmtp.
     40 
     41 $ cat <<EOF > ~/.msmtprc
     42 defaults
     43 
     44 account <account-name>
     45 user <user-name>
     46 auth login
     47 from <email-address>
     48 password <smtp-password>
     49 host <smtp-host-name>
     50 
     51 account default : <account-name>
     52 EOF
     53 
     54 Running
     55 -------
     56 Start one dmc mail daemon for each account
     57 
     58 	$ dmc start
     59 
     60 You can start a shell to the default account using the following command:
     61 
     62 	$ dmc -c
     63 
     64 In the same way you can just execute a command and get the output of it:
     65 
     66 	$ dmc -c on login ls "cat 1" off
     67 
     68 You can change the default account by using 'dmc -e'
     69 
     70 To send a mail add the contact to your addressbook
     71 
     72 	$ echo 'user <foo@bar.com>' >> ~/.dmc/addrbook
     73 
     74 or edit the addressbook
     75 
     76 	$ dmc -a
     77 
     78 Create a mail:
     79 
     80 	$ dmc -m "Hello World"
     81 
     82 Attach files to the last mail created with 'dmc -m':
     83 
     84 	dmc -A file.zip
     85 	#dmc-mime msg attach1.zip | dmc -m `dmc -a user`
     86 
     87 Manually construct the final mail with encoded attachments:
     88 
     89 	$ cd ~/.dmc/box/myaccount/out/
     90 	$ dmc-pack mail.lv3s6l.d/* < mail.lv3s6l /tmp/mail.eml
     91 
     92 Send all the mails in the 'out' box:
     93 
     94 	$ dmc push
     95 
     96 Fetch new mail:
     97 
     98 	$ dmc pull
     99 
    100 Stop the daemons
    101 
    102 	$ dmc stop