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.
|
aminet net>