TurboMailer for Linux Version 2.7.9 TurboMailer for Linux is an advanced bulk e-mailer for sending newsletters and personalized circulars over SMTP servers. Main features: * Sends text and HTML mail, attachments, embedded images * Personalization of mail text / subject from table columns. * Multi-Threaded (multi-parallel) mail transfer * block-by-block transfer with delay option Software home page: http://xellsoft.com/TurboMailer.html http://xellsoft.com/turbomailer.html TurboMailer for Linux can be used for 14 days in free trial mode. After 14 days you MUST register. INSTALLATION ============ 1. TurboMailer for Linux is delivered as archive: turbomailer-linux.tgz Get it for example from commandline with: wget http://www.xellsoft.com/download/turbomailer-linux.tgz 2. Unpack it for example in /usr/local/lib and create a link in /usr/local/bin: cd /usr/local/lib tar xfz /downloadpath/turbomailer-linux.tgz cd /usr/local/bin ln -s /usr/local/lib/tmailer/tmailer tmailer 3. Usage on 64bit Linux: If the executable is not executed, you may have to install the "ia32" libraries. On Debian/Ubuntu for example this is done by: "aptitude install ia32-libs" or "apt-get install ia32-libs" 4. If you get an error about missing libssl0.9.8 upon program execution, then install libssl0.9.8 . On Debian style installations: "apt-get install libssl0.9.8" Or unpack http://www.xellsoft.com/download/libssl.zip into /usr/local/lib/tmailer/ or into one of the global lib folders like /usr/local/lib LICENCE KEY INSTALLATION (after free trial period) ======================== Run "tmailer --license" and enter the key GETTING STARTED =============== 1. Run 'tmailer -h' to see the help and call examples. Then create a test folder and get started: 2. Create a mail text file t_message.txt 3. Or create a mail HTML file t_message.html : Local image paths in HTML will auto-trigger creation of embedded/attached images in the mail 3. Create a test address file t_addresses.txt with some of your addresses: my1st@yourserver.dom my2nd@yourserver.dom my3rd@yourserver.dom 4. Run a simulation run which uses above default files and which does everything except really transfering the mail items. Run it with current UNIX user settings over your local SMTP server: tmailer --simulate -s "My Subject" Or run over a remote SMTP server like: tmailer --simulate -s "My Subject" -v smtp.mailserver -u userID After a confirmation (enter 'y') you'll be asked for the password and if you want to store the password. 5. If everything is ok. make the real run like tmailer -s "My Subject" or: tmailer -s "My Subject" -v smtp.mailserver -u userID 6. Check below Syntax and Examples for advanced usage COMMANDLINE SYNTAX =================== Usage: tmailer [OPTIONS] OPTIONS: -a listfile : Address list file (one address per line or CSV/TabSV table file) with extra personalization columns. Default: "./t_addresses.txt" -t message_file (text/HTML) : The core message. Files ending in .html or .htm are treated as HTML. Messages beginning with "Subject:.." and double newline like "Subject: \n\n" define a mail subject. Otherwise commandline option -s is required. HTML: References to local image files automatically create embedded attached images in the mail. Default: first of "./t_message.txt" , "./t_message.html" -s subject_text : The mail Subject. Enclose subject with spaces in quotes like: -s "My Subject" A subject can also be defined in the message_file (-t). An error is raised, if there is no subject at all. -f from_address : your "From:" email ID Default: @. Example: -f "From Name " -e envelope_from_address : sets explicitely a different email sender address for the SMTP FROM command ("bounce address", "Envelope-Sender") Default: same as -f / SMTP server default -i att_path : Inserts an explicit attachment file into the mail. This option can be used multiple times for multiple attachments -r reply_address : address where recipients shall reply to ( instead of ) -v SMTP_server : the SMTP server and optional port Default: "localhost:25" -y : use secured SMTP with SSL after TLS -u SMTP_user : The SMTP server user-ID for authentication Default: No authentication -p SMTP_pwd : The SMTP server password. It is asked interactively if not present but "-u" used An asked password can be stored (encrypted). -b mails_per_block : Reconnect to SMTP-server after each transmissions. Default: Transfer all mails in one block --block-delay n : Sleep n seconds before sending next block (see "-b") Default: 0 -z max_treads : use parallel threads for transmission. Default: 1 -x x_mailer_tag : the name of the mailer software Default: "sendmail" --bcc bcc_address : Use BCC bulking method and take bcc_address as common display --bcc-n n : Set max. number of mails for one BCC transmission. Default: 20 --bcc-show : Put BCC addresses openly into the mail header --printmime : Display the MIME body of the last transfered mail item --encoding enc : Set the encoding for the input message. Tries to use the UNIX "recode" filter for uncommon transfer encodings. ( Debian Installations: "apt-get install recode" ) Example: tmailer --encoding greek7 -t mail.gr7.txt Default: Locale encoding set/guessed for machine/user (LC_CTYPE) --utf8 : UTF8 unicode encoding for message file (= "--encoding utf8") Example: recode --list recode greek7:utf8 < mail.gr7.txt > mail.utf8.txt tmailer --utf8 -t mail.utf8.txt --license : The license key will be asked and stored --simulate : simulate everything without transfering mails -c : Don't ask confirmation for sending -l loglevel : 3=default 2=print no individual addresses on console -h / --help : Display this help Examples: tmailer --simulate tmailer -a list.txt -v smpt.mailserver -s "My Subject" -t mail.txt tmailer -v smtp.gmail.com -y -t mail.html -u xy@gmail.com -f xy@gmail.com