Desktop widgets application

   Author:       jPV^RNO
   Uploader:     jpv morphos-user com (jPV^RNO)
   Type:         util/wb
   Version:      1.6
   Requires:     AmiSSL v5
   Architecture: ppc-amigaos
   Date:         2023-11-07
   Readme:       http://aminet.net/util/wb/RNOWidgets_OS4.readme
   Downloads:    111

http://aminet.net/util/wb/RNOWidgets_OS4.lha

ABOUT

-----

Desktop widgets are small individual utilities placed on your desktop

and RNOWidgets is a single application incorporating several of them.

RNOWidgets contains widgets for calendar (ISO), analog clock, digital clock,

notes, pictures (local and net), RSS/Atom feeds, sticker, and weather.

Please consider the time and effort I put in to create this utility for your

use and enjoyment. So, if you feel it is useful to you, please send a donation

that represents the benefit you gain from using it to me at the address found

in this ReadMe.txt file (Uploader) or click the Donate button at

https://jpv.amigaaa.com/

FEATURES

--------

- Stylish user configurable widgets (graphics, fonts, colors, etc., can be

freely swapped)

- Pre-defined themes

- All widgets are freely re-sizeable and moveable

- Supports alpha channel transparency and has an option to create window drop-

shadows automatically (with or without compositing/accelerated layers)

- Versatile alarm system

- ARexx support

- Compatible with clock skins from the Enhancer Software package

REQUIREMENTS

------------

- AmiSSL v5 (http://aminet.net/search?query=amissl)

INSTALLATION

------------

- Copy the whole directory anywhere you want and just launch the program

USAGE

-----

General:

- Use the pull-down menu or keyboard shortcuts to select the widgets you want

to be displayed

- The "Snapshot windows" (Command+.) menu item saves widget sizes, positions,

and their state if a widget is shown or hidden

- All widgets are freely re-sizeable from the lower right corner

- All widgets are freely moveable from the top edge of a widget

- The "Edit alarms" (Command+e) menu item opens the alarm editor window

- Alarms work globally, so they are not tied to a specific widget

Calendar widget:

- Months can be browsed using the mouse wheel, page up/down & left/right keys

- The middle mouse button or the Enter key switches back to the current month

- "Event strings" can be added by clicking dates or weekdays

- Clicking the month name, pressing the space bar, or using the up/down keys

shows a list of forthcoming events for the current month

Notes widget:

- Marking text with the left mouse button pressed and then releasing it, will

copy the marked text to the clipboard

- Underlined URLs can be double-clicked so they open in your browser

- Notes can be added by clicking the "+" sign with the mouse or by pressing

the "insert" key

- Notes can be deleted by clicking the "x" letter or by pressing the Ctrl+Del

keyboard combination

- Notes can be browsed with the mouse wheel or with the page up/down keys or

by left clicking with the mouse on the small central "arrowheads"

- The "pause" key will pause automatic cycling if it's enabled

Pictures widget:

- Pictures can be browsed using the mouse wheel, page up/down keys, and

left/right keys

- Double-clicking or pressing the "f" key opens pictures on a fullscreen

- The spacebar or the "pause" key pauses automatic cycling

- HTTP(S) and FTP(S) protocols are supported for images from the Internet

- "r" and "enter" keys do a forced refresh of the current picture

- The following placeholders can be used for paths and URLs:

<u> . . . - Unix timestamp

<d> . . . - Day number (1)

<dp> . . - Day number with padding (01)

<m> . . . - Month number (1)

<mp> . . - Month number with padding (01)

<y> . . . - Year (2023)

<ya> . . - Year in its abbreviated form (23)

<$name> . - Name of an ENV variable that is used for the content

Feeds (RSS/Atom) widget:

- Clicking the feed title will open a related web page within a web-browser

- Clicking a feed item will open the full story within a web-browser

- Alternative feeds can be browsed by using a mouse-wheel, or by pressing the

page up/down or left/right keys

- Up/down keys show previous or next pages of the current feed

- The spacebar or the "pause" key pauses automatic cycling

- The "r" and "Enter" keys do a forced refresh of the feed

- Double-clicking an "empty" area or pressing the "f" key opens a fullscreen

display

Weather widget:

- Widget's layout is dynamic so resizing it wider affects arrangement of its

contents

- Locations can be browsed with the mouse wheel, page up/down keys, and

left/right keys

- The spacebar or the "pause" key pauses automatic cycling

- Double-clicking or pressing the "f" key opens a fullscreen 5-day forecast

SETTINGS

--------

The settings application can be opened from the pull-down menu. See the MUI

quick help pop-ups for information about the various settings.

Settings are saved to ENV:RNOWidgets/ and they can also be altered without

the settings GUI. For example, to disable the Notes widget type in the Shell:

SetEnv SAVE RNOWidgets/notes 0

The separate "Compositing" setting in the pull-down menu is used to define if

windows are drawn with hardware accelerated layers. Window shadows and alpha

transparent graphics are then updated in real-time by the hardware. This only

works if the program is running on a 32bit "enhanced mode" screen on MorphOS

(System settings -> Screens -> Enhanced Display) or "compositing" is enabled

in OS4 (Prefs -> GUI -> Effects).

Compositing mode can also be forced on or off by typing the following line

into a Shell window before launching the program (0=off, 1=on, 2=default),

for example: SetEnv SAVE RNOWidgets/compositing 0

If you have difficulties moving or re-sizing windows with irregular shaped

transparent backgrounds, enable this setting from the Shell:

SetEnv SAVE RNOWidgets/safecompositing 1

COMMAND LINE OPTIONS AND ICON TOOLTYPES

---------------------------------------

RNOWidgets uses non-standard command line arguments. Arguments must be given

in the form of (note the "-" prefix): -argument parameter

Allowed arguments:

-delay <n> . - Delays the startup for <n> seconds

-iconify . . - Iconifies the program after launching it

-cxkey <k> . - Sets a system wide hotkey to iconify/un-iconify the program

-args . . . - Shows the allowed arguments

Example:

RNOWidgets -delay 5 -cxkey "ctrl alt r"

The same arguments can be used as icon tooltypes, by omitting the "-" prefix.

Examples:

DELAY=5

CXKEY=rcommand shift r

AREXX

-----

Program's ARexx port is RNOWIDGETS and its supported commands are:

HELP . . . . . . . . . . - Returns a summary of the available commands

SHOW <name> . . . . . . . - Opens a widget

HIDE <name> . . . . . . . - Closes a widget

TOGGLE <name> . . . . . . - Toggles a widget on / off

ICONIFY . . . . . . . . . - Iconifies the program

UNICONIFY . . . . . . . . - Un-iconifies the program

TOGGLEICONIFY . . . . . . - Toggles the iconify state

ALARMS LIST . . . . . . . - Returns a list of alarms

QUIT . . . . . . . . . . - Quits the program

NOTES NEXT . . . . . . . - Loads the next note

NOTES PREV . . . . . . . - Loads the previous note

NOTES PAUSE . . . . . . . - Pauses the automatic cycling of the notes

NOTES GETTEXT . . . . . . - Returns the contents of the shown note

CALENDAR NEXT . . . . . . - Shows the next month

CALENDAR PREV . . . . . . - Shows the previous month

CALENDAR CURRENT . . . . - Shows the current month

CALENDAR EVENTS . . . . . - Toggles between the calendar and event list views

CALENDAR SETEVENT <n> <s> - Sets a new event, <n> is a date in YYYYMMDD

format and <s> is an event string

CALENDAR GETEVENT <n> . . - Gets an event string

CALENDAR REMEVENT <n> . . - Removes an event

PICTURES NEXT . . . . . . - Loads the next picture

PICTURES PREV . . . - Loads the previous picture

PICTURES FULLSCREEN . . . - Toggles the fullscreen mode

PICTURES PAUSE . . . . . - Pauses the automatic cycling of the pictures

PICTURES REFRESH . . . . - Forces a picture to be re-loaded

PICTURES GETPATH . . . . - Returns the path/URL of the shown picture

FEEDS NEXT . . . . . . . - Shows the next feed

FEEDS PREV . . . . . . . - Shows the previous feed

FEEDS NEXTPAGE . . . . . - Shows the next page of a feed

FEEDS PREVPAGE . . . . . - Shows the previous page of a feed

FEEDS PAUSE . . . . . . . - Pauses the automatic cycling of the feeds

FEEDS REFRESH . . . . . . - Forces a feed to be re-loaded

FEEDS GETURL . . . . . . - Returns the URL of the shown feed

STICKER ANGLE <n> . . . . - Rotates the sticker by the specified angle

WEATHER NEXT . . . . . . - Shows the next location

WEATHER PREV . . . . . . - Shows the previous location

WEATHER PAUSE . . . . . . - Pauses the automatic cycling of the locations

WEATHER GETTEMP . . . . . - Returns the temperature of the shown location

WEATHER GETWIND . . . . . - Returns the wind speed of the shown location

WEATHER GETLOCATION . . . - Returns the shown location

Where <name> can be CALENDAR, CLOCKANALOG, CLOCKDIGITAL, NOTES, PICTURES,

FEEDS, STICKER, or WEATHER.

Example:

RX "ADDRESS RNOWIDGETS;TOGGLE NOTES"

HISTORY

-------

Version 1.6:

- Added a fullscreen 5-day forecast display for the Weather widget

- Added a 12-hour option to the Digital Clock widget

- Added support for Atom feeds and renamed the RSS widget as the Feeds widget

- Added fullscreen mode for the Feeds widget

- Added placeholders for date/env content in the Pictures widget's paths/URLs

- Fixed a Pictures widget fullscreen crash issue that was introduced in v1.5

- Fixed a memory leak in the Pictures widget

- Rewrote the weather API code

- Other small changes

Version 1.5:

- The first public release for OS4

WEB

---

- Video presentation of RNOWidgets: https://m.youtube.com/watch?v=09pzl2mNeYg

- Please visit https://jpv.amigaaa.com/ for screenshots, support, donations,

and to check out more of my other software

- This program is made with Hollywood: https://www.hollywood-mal.com/

THANKS TO

---------

- Konrad 'recedent' Czuba for graphics (the Miglanc theme)

- Densho/RNO for the logo

- Neil Pearson for testing and proof-reading

- Papiosaur for butterfly stickers (buy real ones from www.warmup-asso.org)

DISCLAIMER

----------

This program is made available to you as DONATIONWARE, so if you use it then

please make a PayPal donation to support its author, and future development.

The author accepts no liability for any damage caused to your system, other

connected peripherals, or your time management by using this software.

Contents of util/wb/RNOWidgets_OS4.lha

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                 4247   10589  40.1% -lh5- 6186 Nov  1 17:52 RNOWidgets_OS4/ReadMe.txt
[generic]                 3126    5092  61.4% -lh5- 8a46 Apr  7  2017 RNOWidgets_OS4/ReadMe.txt.info
[generic]              3701973 7053460  52.5% -lh5- 01a7 Nov  7 17:58 RNOWidgets_OS4/RNOWidgets
[generic]                 9539   11420  83.5% -lh5- fbf8 Apr  7  2017 RNOWidgets_OS4/Screenshots.info
[generic]                49421   49421 100.0% -lh0- a8ae Aug  5  2019 RNOWidgets_OS4/Screenshots/RNOWidgets_Banner_750x370.png
[generic]                99104   99104 100.0% -lh0- 5c8d Nov  2 19:44 RNOWidgets_OS4/Screenshots/RNOWidgets_Feeds_Fullscreen_1.png
[generic]               197284  197284 100.0% -lh0- 3bf1 Nov  2 19:42 RNOWidgets_OS4/Screenshots/RNOWidgets_Feeds_Fullscreen_2.png
[generic]                26765   26765 100.0% -lh0- e0f2 Aug  5  2019 RNOWidgets_OS4/Screenshots/RNOWidgets_Icon_175x110.png
[generic]               185002  185002 100.0% -lh0- 2096 Nov  2 19:36 RNOWidgets_OS4/Screenshots/RNOWidgets_Weather_Forecast.png
[generic]                54935   54935 100.0% -lh0- 44f2 Jun 16  2018 RNOWidgets_OS4/Screenshots/RNOWidgets_Alarms.png
[generic]               354331  354331 100.0% -lh0- acda Jun 16  2018 RNOWidgets_OS4/Screenshots/RNOWidgets_All.png
[generic]               136804  136804 100.0% -lh0- 6887 May 13  2018 RNOWidgets_OS4/Screenshots/RNOWidgets_Anim.gif
[generic]                16673   16673 100.0% -lh0- 571c Oct 11  2017 RNOWidgets_OS4/Screenshots/RNOWidgets_Logo.png
[generic]               115391  115391 100.0% -lh0- 1591 Jun 16  2018 RNOWidgets_OS4/Screenshots/RNOWidgets_Settings_Calendar.png
[generic]               101134  101134 100.0% -lh0- c2e1 Jun 16  2018 RNOWidgets_OS4/Screenshots/RNOWidgets_Settings_RSS.png
[generic]                96307   96307 100.0% -lh0- fa69 Jun 16  2018 RNOWidgets_OS4/Screenshots/RNOWidgets_Settings_Weather.png
[generic]                  201     279  72.0% -lh5- bdb2 Jan 18  2018 RNOWidgets_OS4/Scripts/Alarm_Example.rexx
[generic]                 9539   11420  83.5% -lh5- fbf8 Apr  7  2017 RNOWidgets_OS4.info
[generic]                 9539   11420  83.5% -lh5- fbf8 Aug  5  2019 RNOWidgets_OS4/PNG-icon.info
[generic]                 5534    5534 100.0% -lh0- 280d Apr  8  2019 RNOWidgets_OS4/PNG-icon/RNOWidgets.info
[generic]                 1034    2767  37.4% -lh5- 5370 Aug  5  2019 RNOWidgets_OS4/RNOWidgets.info
[generic]                  227     304  74.7% -lh5- 71a8 Jan 18  2018 RNOWidgets_OS4/Scripts/Alarm_Example.script
[generic]                  443     773  57.3% -lh5- 60ad Jan  8  2018 RNOWidgets_OS4/Scripts/Calendar_AOrganiser.rexx
[generic]                  205     266  77.1% -lh5- b3b1 Jan  4  2018 RNOWidgets_OS4/Scripts/Calendar_Example.script
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        24 files 5178758 8546475  60.6%            Nov  8 04:39

Aminet © 1992-2023 Urban Müller and the Aminet team. Aminet contact address: <aminet aminet net>