Difference between revisions of "Alpine"

From ArchWiki
Jump to: navigation, search
(Introduction)
(Configuration for use with IMAP)
Line 23: Line 23:
 
  alpine
 
  alpine
  
At the top of your screen you will see various lines you can edit by pressing "C", for "change value" (I've pasted an example in below), you'll probably want
+
You will see the main menu for alpine, you can select various sub-menus by moving your cursor with the arrow keys.  You should also note that a
 +
list of handy commands is given at the bottom of the screen including "?" for built in help (see below).
 +
 
 +
To get to the configuration options we want to type "S" for "setup" and then "C" for "config"(or you can select these by using the arrow keys and return)  At the top of your screen you will see various lines you can edit by pressing "C", for "change value" (I've pasted an example in below), you'll probably want
 
to fill in you name, the name of your mailserver in "User Domain" (although you might have to overide this later, more on
 
to fill in you name, the name of your mailserver in "User Domain" (although you might have to overide this later, more on
 
that later), your SMTP server for sending mail and, if you want to, the location of things like your saved message folder
 
that later), your SMTP server for sending mail and, if you want to, the location of things like your saved message folder

Revision as of 05:50, 1 October 2008

Alpine: A Console Based E-mail and News Client

Introduction

Alpine is based on pine, a text-based E-mail and newsclient that was originally released by the university of Washington in 1991. Right now, this wiki page is just a quick and dirty guide to configuring Alpine to use with a remote mailserver using IMAP.

Installation

Alpine is a package in Extra with some light dependancies, libldap, heimdal>=1.2, and gettext but you can grab them all with:

pacman -S alpine

You might also want to grab something to check your spelling, like:

pacman -S aspell

Configuration for use with IMAP

Alpine can be configured directly from the config file in your home folder called ".pinerc", but it's ussaully easier to use the in program configuration tools (which are pretty comprehensive anyway). You can also create a system wide pinerc file if you want to, but that's beyond the scope of this page.

To start alpine call up a console or a terminal emulator and type, you guessed it:

alpine

You will see the main menu for alpine, you can select various sub-menus by moving your cursor with the arrow keys. You should also note that a list of handy commands is given at the bottom of the screen including "?" for built in help (see below).

To get to the configuration options we want to type "S" for "setup" and then "C" for "config"(or you can select these by using the arrow keys and return) At the top of your screen you will see various lines you can edit by pressing "C", for "change value" (I've pasted an example in below), you'll probably want to fill in you name, the name of your mailserver in "User Domain" (although you might have to overide this later, more on that later), your SMTP server for sending mail and, if you want to, the location of things like your saved message folder and postponed message folder.

Some notes on setting up your SMTP server, as you can see below I've specified my mailserver and which port to connect to, you also need to specify your username on that server (probably your e-mail address) and if you are using some method of incryption ssl or tls note the format:

mailserver.org:portnumber/user=username/ssl (or tls)

Also note the format for where I've told Alpine to keep my saved and postponed messages, since I want them stored on the mailserver, and not locally, I've added an entry with form:

{mailserver.org:portnumber/user=username/ssl}/path/to/folder

You need to put the full entry you've specified for you SMTP Server into "{}" before the path name to the folder on the mailserver.

Personal Name                     = Jim Bob
User Domain                       = mailserver.org
SMTP Server (for sending)         = mailserver.org:465/user=jimbob123/ssl
NNTP Server (for news)            = <No Value Set>
Inbox Path                        = <No Value Set: using "inbox">
Incoming Archive Folders          = <No Value Set>
Pruned Folders                    = <No Value Set>
Default Fcc (File carbon copy)    = {mailserver.org:465/user=jimbob123/ssl}~/mail/sent-mail
Default Saved Message Folder      = <No Value Set: using "saved-messages">
Postponed Folder                  = {mailserver.org:465/user=jimbob123/ssl}~/mail/drafts
Read Message Folder               = <No Value Set>
Form Letter Folder                = <No Value Set>
Trash Folder                      = <No Value Set: using "Trash">
Literal Signature                 = <No Value Set>
Signature File                    = <No Value Set: using ".signature">
Feature List                      =

In this day and age, you probably want to set alpine up receive e-mails from another server using imap or pop, to do this we need to enable some things, in particular, check the boxes in the section "Folder Preferences" for "Enable Incoming Folders Collection" and "Enable Incoming Folders Checking". There's a bunch of other fun stuff to configure, but you can come back to that later.

Now from the main menu type "L" to open "Folder List", then select "Incoming Folders". Now you'll probably see your defualt inbox, which I'm assuming you'll want to leave alone incase you recieve local mail. To add another folder to recieve mail from a remote server type "A" to add a folder.

Alpine prompts you for "name of server to contain folder", enter your mailserver with the format:

"mailserver.org:993/user=jimbob123/ssl"

where mailserver.org is the name of your mailserver, 993 should be replaced by the proper port to connect to, jimbob123 should be replaced by your username (probably your e-mail address) and ssl should be replaced by tls if you are using tls instead of ssl.

Now it will prompt you for the name of the folder on you mailserver to use, it's probably "INBOX" and if it isn't hopefully you can find out from your mail provider what it is.

Then it will ask you for a nickname, type whatever you want to call the folder. At this point you might get prompted for your password on the mailserver, enter it and you should be able to read e-mail!

Setting up Other Imap folders

Great, now you can read your INBOX, but what about the REST of your Imap folders? We'll fix that know:

Type "E" to exit setup and make sure that you save the changes. This should put you back at the main menu type "S" agian to bring up the setup menu, but this time pick "L" for collectionLists.

Enter your mailserver info below using the format you should be getting used to by now:


Nickname  : My Mailserver
Server    : mailserver.org:993/user=jimbob123/ssl
Path      : ~/mail/
View      :


   Fill in the fields above to add a Folder Collection to your
   COLLECTION LIST screen.
   Use the "^G" command to get help specific to each item, and
   use "^X" when finished.

Note that "Path" is the path on the remote server and you DON'T have to write:

{mailserver.org:993/user=jimbob123/ssl}~/mail/

You only need to give the local path on the mailserver (in this case ~/mail/)

Setting Up A Proper Return Address

If you've followed the steps above you can read and write e-mails, but you're probably not specifying your return address correctly, in fact, you will specify you return address properly if and only if the user name on the host computer which is run alpine is the same as your e-mail address on the mail server. In order to fix this we open setup again (type "M" for main menu, type "S" for setup). Then find "Customized Headers" (either use the "Whereis" command to search, or page down a few pages to find this) and change the value to

From:  Jim Bob <jimbob123@mailserver.org>

Of course, replace Jim Bob with your name and put your proper e-mail address in the <>. While this works, the behavior of alpine with respect to this field is somewhat complex if you want now more use:

Built in Help

To see built-in help files on just about anything you can type "?", if you have an item highlighted, this will give you help on that item.

What else can you configure?

Almost anything, in particular you can specify which colors to use, (from the main menu "S" for set up "K" for colors ... should be natural for KDE users), a browser to open external links (this is in the "Config" setup that we've previously been modifying"), an alternate text editor to use, different folder views, etc.

Externel Links

Official Alpine Page this page includes links to un-official Alpine pages that have some handy tutorials (argue better than the one I've provided here), hit "C" to open the config menu.