Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
panel-plugins:xfce4-mailwatch-plugin:start [2019/11/09 12:26] – created kevinbowenpanel-plugins:xfce4-mailwatch-plugin:start [2025/05/20 15:47] (current) – [Installation] Meson andreldm
Line 1: Line 1:
 +~~NOTOC~~
 +{{ :panel-plugins:xfce4-mailwatch.png?nolink|}}
 ====== Mailwatch ====== ====== Mailwatch ======
- 
-===== About ===== 
- 
 Xfce4 Mailwatch Plugin is a multi-protocol, multi-mailbox mail watcher Xfce4 Mailwatch Plugin is a multi-protocol, multi-mailbox mail watcher
 for the Xfce4 panel. for the Xfce4 panel.
 +  * **[[#Properties|Properties]]**
 +  * **[[#Mailbox Configuration|Mailbox Configuration]]**
 +  * **[[#IMAP|IMAP Settings]]**
 +  * **[[#POP3|POP3 Settings]]**
 +  * **[[#GMAIL|GMail Settings]]**
 +  * **[[#Maildir|Maildir Settings]]**
 +  * **[[#Mbox|Mbox Settings]]**
 +  * **[[#MH Maildir|MH Maildir Settings]]**
 +  * **[[#Latest Release|Latest Release]]**
 +  * **[[#Installation|Installation]]**
 +  * **[[#Source Code Repository|Source Code Repository]]**
 +  * **[[#Reporting Bugs|Reporting Bugs]]**
 +
  
 ===== Features ===== ===== Features =====
Line 31: Line 43:
 forcing an update and the about box. forcing an update and the about box.
  
 +----
 ===== Properties ===== ===== Properties =====
  
Line 37: Line 50:
 by choosing //Properties//. by choosing //Properties//.
  
-Mailwatch main settings: +<figure "Mailwatch Main Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-properties.png|Mailwatch Main Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-properties.png}} +</figure>
- +
-Mailboxes+
  
 The main controls for managing mailboxes are //Add//, //Edit//, and The main controls for managing mailboxes are //Add//, //Edit//, and
Line 72: Line 83:
 enabled, provides a visual indication of new log events in the panel. enabled, provides a visual indication of new log events in the panel.
  
-Log Window:+<figure "Mailwatch Log Window"> 
 +{{:panel-plugins:xfce4-mailwatch-plugin-log-window.png|Mailwatch Log Window}} 
 +</figure>
  
-{{projects:panel-plugins:xfce4-mailwatch-plugin-log-window.png}} +<figure "Mailwatch Panel Indicator"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-panel-indicator.png|Mailwatch Panel Indicator}} 
-Panel Indicator+</figure>
- +
-{{projects:panel-plugins:xfce4-mailwatch-plugin-panel-indicator.png}}+
  
 +[[|Back To Top]]
 +----
 ===== Mailbox configuration ===== ===== Mailbox configuration =====
  
Line 90: Line 103:
 informative description of the mailbox in the label below. informative description of the mailbox in the label below.
  
-Mailbox type selection: +<figure "Mailbox Type Selection"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-mailbox-type.png|Mailbox Type Selection}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-mailbox-type.png}}+</figure>
  
 ==== IMAP ==== ==== IMAP ====
Line 105: Line 118:
 IMAP settings dialog. IMAP settings dialog.
  
-IMAP Settings Dialog+<figure "IMAP Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-imap-settings.png|IMAP Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-imap-settings.png}}+</figure>
  
 Mailbox Name Mailbox Name
Line 137: Line 150:
 === Advanced Settings === === Advanced Settings ===
  
-Advanced IMAP settings: +<figure "Advanced IMAP Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-imap-advanced.png|Advanced IMAP Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-imap-advanced.png}}+</figure>
  
 Connection Connection
Line 170: Line 183:
 often to something like "mail", "Mail", or "Maildir". often to something like "mail", "Mail", or "Maildir".
  
-New mail folders: +<figure "New Mail Folders Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-imap-new-folders.png|New Mail Folders Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-imap-new-folders.png}}+</figure>
  
 Since IMAP supports viewing mail in multiple folders, it's possible Since IMAP supports viewing mail in multiple folders, it's possible
Line 181: Line 194:
 course, you'll need to enter the server information first. course, you'll need to enter the server information first.
  
 +
 +[[|Back To Top]]
 +----
 ==== POP3 ==== ==== POP3 ====
  
Line 188: Line 204:
 as advanced a protocol as IMAP. as advanced a protocol as IMAP.
  
-POP3 Settings+<figure "POP3 Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-pop3-settings.png|POP3 Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-pop3-settings.png}}+</figure>
  
 Mailbox Name Mailbox Name
Line 217: Line 233:
 === Advanced Settings === === Advanced Settings ===
  
-POP3 Advanced Settings+<figure "POP3 Advanced Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-pop3-advanced.png|POP3 Advanced Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-pop3-advanced.png}}+</figure>
  
 Connection Connection
Line 236: Line 252:
 then checking the log viewer for errors. then checking the log viewer for errors.
  
 +
 +[[|Back To Top]]
 +----
 ==== GMail ==== ==== GMail ====
  
Line 241: Line 260:
 securely by using HTTPS and GMail's RSS feed. securely by using HTTPS and GMail's RSS feed.
  
-GMail Settings+<figure "GMail Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-gmail-settings.png|GMail Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-gmail-settings.png}}+</figure>
  
 GMail Server GMail Server
Line 259: Line 278:
 which contains three subdirectories (''cur'', ''new'', ''tmp''). which contains three subdirectories (''cur'', ''new'', ''tmp'').
  
-Maildir Settings+<figure "Maildir Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-maildir-settings.png|Maildir Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-maildir-settings.png}}+</figure>
  
 Mailbox Name Mailbox Name
Line 280: Line 299:
 local filesystem, or at least a local network. local filesystem, or at least a local network.
  
 +
 +[[|Back To Top]]
 +----
 ==== Mbox ==== ==== Mbox ====
  
Line 287: Line 309:
 a directory tree. a directory tree.
  
-Mbox Settings+<figure "Mbox Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-mbox-settings.png|Mbox Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-mbox-settings.png}}+</figure>
  
 Mailbox Name Mailbox Name
Line 307: Line 329:
 local filesystem, or at least a local network. local filesystem, or at least a local network.
  
 +[[|Back To Top]]
 +----
 ==== MH Maildir ==== ==== MH Maildir ====
  
Line 314: Line 338:
 mailboxes. mailboxes.
  
-MH Maildir Settings+<figure "MH Maildir Settings Dialog"> 
- +{{:panel-plugins:xfce4-mailwatch-plugin-mh-settings.png|MH Maildir Settings Dialog}} 
-{{projects:panel-plugins:xfce4-mailwatch-plugin-mh-settings.png}}+</figure>
  
 Mailbox Name Mailbox Name
Line 330: Line 354:
 local filesystem, or at least a local network. local filesystem, or at least a local network.
  
-===== Downloads ===== 
  
-The normal (and best) way to get this plugin is to use the package +[[|Back To Top]]
-manager or port system of your operating system.+
  
-If it isn't available there, or if you want a different version, you +----
-can download it in source form from +
-[[http://archive.xfce.org/src/panel-plugins/xfce4-mailwatch-plugin]].+
  
-You can retrieve the current development version of the plugin from +===== Latest Release =====
-Xfce’s Git repository using the following command:+
  
-<code> +{{rss>https://archive.xfce.org/feeds/project/xfce4-mailwatch-plugin 1 date 2h}}
-git clone git://git.xfce.org/panel-plugins/xfce4-mailwatch-plugin +
-</code>+
  
-It can also be browsed at [[http://git.xfce.org/panel-plugins/xfce4-mailwatch-plugin]].+[[https://gitlab.xfce.org/panel-plugins/xfce4-mailwatch-plugin/-/blob/master/NEWS|Read the CHANGELOG]] 
 + 
 +  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-mailwatch-plugin/|Download current release]]** (older versions of this component are also available here) 
 + 
 +[[|Back to Top]] 
 + 
 +----
  
 ===== Requirements ===== ===== Requirements =====
Line 354: Line 377:
   * **Optional but recommended:** GNU TLS, version 1.2.0 or greater and libgcrypt, version 1.2.0 or greater, for secure IMAP and POP3 support   * **Optional but recommended:** GNU TLS, version 1.2.0 or greater and libgcrypt, version 1.2.0 or greater, for secure IMAP and POP3 support
  
 +----
  
 ===== Installation ===== ===== Installation =====
  
-In order to install a released version fo Mailwatch, issue the+In order to install a released version of Mailwatch or from git, issue the
 following commands from the root of the Mailwatch source tree: following commands from the root of the Mailwatch source tree:
  
 <code> <code>
-./configure --prefix=${xfce_prefix} +meson setup --prefix=${xfce_prefix} build 
-make +meson compile -C build 
-make install+meson install -C build
 </code> </code>
  
 Where ''${xfce_prefix}'' is the location where Xfce 4 is installed. On Where ''${xfce_prefix}'' is the location where Xfce 4 is installed. On
-most systems this should be ''/usr''. The make install portion should+most systems this should be ''/usr''. The meson install portion should
 be run as root (or via sudo) if the prefix is a system location. be run as root (or via sudo) if the prefix is a system location.
  
-In order to install the Git version of Mailwatch, issue the following +----
-commands instead: +
- +
-<code> +
-$ ./autogen.sh --prefix=${xfce_prefix} +
-$ make +
-$ make install +
-</code>+
  
 ===== Contributions ===== ===== Contributions =====
  
-Bug reports and patches can be submitted on +The Mailwatch plugin is easily extensible to support extra mailbox types if needed.
-[[https://bugzilla.xfce.org|Xfce Bugzilla]]. Development discussion +
-should take place on the +
-[[https://mail.xfce.org/mailman/listinfo/goodies-dev|Xfce Goodies +
-Development Mailing List]]. The Mailwatch plugin is easily extensible +
-to support extra mailbox types if needed.+
  
 If you’d like to see Mailwatch translated into another language, If you’d like to see Mailwatch translated into another language,
-please visit the page with informations for+please visit the page with information for
 [[http://www.xfce.org/getinvolved/translation|translators]]. [[http://www.xfce.org/getinvolved/translation|translators]].
 +
 +----
 +
 +===== Source Code Repository =====
 +
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-mailwatch-plugin]]
 +
 +----
 +===== Reporting Bugs =====
 +
 +  * **[[:panel-plugins:xfce4-mailwatch-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports
 +
 +[[|Back To Top]]
 +----
 +[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]