<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr">Hi Devs --<div><br></div><div>I have been struggling to get this plugin to work correctly after participating in <a href="https://forum.xfce.org/viewtopic.php?id=6823">an old Forum thread</a> that has recently been revived. It is important to us because users frequently ask about alarms/timers and we would like to be able to point to this. </div><div><br></div><div>Part of the problem is the GUI itself, about which I will post at a later time. I will say en passant that it is remarkable that there is no Help button on the GUI; the user has to first know there is one and where it is, then go and consult it--a slow, cumbersome and annoying procedure.</div><div><br></div><div>But for now I am interested in trying to bring the Help file up to a level that would be useful to a wider audience. I provide here a possible revision of the current doc that aims for 3 goals: 1) update terminology for titles, labels, etc; 2) clarify various obscure features; and 3) suggest changes to make the entire document more user-friendly. </div><div>==================</div><div>==================</div><div><div><b>NOTE: images need updating</b> </div><div><br></div><div>====== Timer ======</div><div>This is a simple plugin that lets the user run an alarm at a specified time or at the end of a specified countdown period.</div><div><br></div><div>  * **[[#Screenshots|Screenshots]]**</div><div>  * **[[#Latest Release|Latest Release]]**</div><div>  * **[[#Source Code Repository|Source Code Repository]]**</div><div>  * **[[#Reporting Bugs|Reporting Bugs]]**</div><div><br></div><div>----</div><div><br></div><div>===== Usage =====</div><div>The plugin consists of a Panel icon and a Properties window.</div><div><b><br></b></div><div><b>Panel icon</b></div><div>The icon displays a progress bar showing the percentage of the time elapsed. The bar changes color when active from silver to blue.</div><div>Left-clicking on the icon opens a menu of available alarms. After selecting one, the user can start or stop the timer by selecting the "start/stop timer" entry in the same menu. Right-clicking on it provides access to Properties.</div><div><b><br></b></div><div><b>Properties window</b></div><div>The Xfce4 Timer Options window allows users to add, edit, remove and arrange alarms. </div><div><br></div><div>Each alarm is either a countdown or is run at a specified time. By default a simple dialog pops up at the end of the countdown. </div><div><br></div><div>The user can choose an external command to be run as the alarm command for all events, or for just a particular one. An option allows this command to be repeated a specified number of times with a given interval between repetitions. Here is an example that uses a simple ping:</div><div><code>play /usr/share/sounds/freedesktop/stereo/completed.oga</code></div><div>A different external command may be used for a specific event by adding it in the Alarm add/edit window.</div><div><br></div><div>=====Known issues=====</div><div>The icon may be nearly invisible against some themes. The colors being used can be adjusted with a code snippet in the css file. For GTK3, the following code can be used to adjust inactive ("trough") and active ("progress") colors. For example:  </div><div><code>#PLUGIN_NAME progress { </div><div><span style="white-space:pre"> </span>background-color: silver; </div><div>}</div><div><br></div><div>#PLUGIN_NAME trough { </div><div><span style="white-space:pre">    </span>background-color: red; </div><div>} </code></div><div>The actual plugin name, usually something like <b>xfce4-timer-plugin-2</b> where the widget number at the end is particular to individual desktops, can be found by hovering over its widget on the  Panel Properties > Items tab.</div></div><div>==========</div><div>==========</div><div>Notes</div><div>1) It would be much better to have a default sound file already filled in so that the timer could be used OOTB</div><div>2) The sound file I used as an example (or another that would work without fuss) could be supplied with the app to make the user's job much easier</div><div>3) Not sure you want to include the Known Issue section, but we find that appearance questions come up pretty frequently with 4.14.</div><div><br></div><div>I hope this is of some use--thanks for all you do.</div><div><br></div><div>Jerry</div></div></div></div></div></div></div></div></div></div>