RNOWidgets
Description:	Desktop widgets application
Download:	rnowidgets.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size:	5Mb
Version:	1.6
Date:	07 Nov 2023
Author:	jPV^RNO
Submitter:	jPV^RNO
Homepage:	https://jpv.amigaaa.com/RNOWidgets/
Category:	utility/workbench
Replaces:	utility/workbench/rnowidgets.lha
License:	Other
Distribute:	yes
Min OS Version:	4.1
FileID:	12716
Snapshots:   Videos:
Comments:	4
Snapshots:	8
Videos:	1
Downloads:	95  (Current version)
	176  (Accumulated)
Votes:	4 (0/0)  (30 days/7 days)

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.