Short: Desktop widgets application Author: jPV^RNO Uploader: jpv morphos-user com (jPV^RNO) Type: util/wb Version: 1.6 Architecture: ppc-morphos 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 INSTALLATION ------------ - Copy the whole directory anywhere you want and just launch the program - To start the program at boot time, add the following line to the SYS:S/user-network-startup file (change the path to suit its real location): Run >NIL: SYS:Applications/RNOWidgets/RNOWidgets -delay 2 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: . . . - Unix timestamp . . . - Day number (1) . . - Day number with padding (01) . . . - Month number (1) . . - Month number with padding (01) . . . - Year (2023) . . - 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 . - Delays the startup for seconds -iconify . . - Iconifies the program after launching it -cxkey . - 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 . . . . . . . - Opens a widget HIDE . . . . . . . - Closes a widget TOGGLE . . . . . . - 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 - Sets a new event, is a date in YYYYMMDD format and is an event string CALENDAR GETEVENT . . - Gets an event string CALENDAR REMEVENT . . - 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 . . . . - 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 can be CALENDAR, CLOCKANALOG, CLOCKDIGITAL, NOTES, PICTURES, FEEDS, STICKER, or WEATHER. Example: RXCmd 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: - Fixed compositing support detection (for hardware accelerated transparency) - Uses openssl3.library instead of AmiSSL for HTTPS URLs - Linked required plugins in the executable (work better from WBStartup, etc.) - Updated RSS presets - Other small changes Version 1.4: - Added SSL support for network enabled widgets (requires AmiSSL v4) - Added CXKEY (global hotkey) option to un-/iconify (toggles) widgets - Changed the console output method - RSS: Updated presets - RSS: Added RDF compatibility Version 1.3: - Changed the audio output method in the alarm system, as version 1.2 kept the AHI device open all the time, and that blocked audio from other programs in certain situations - Added a volume control option for alarm sounds Version 1.2: - New weather widget - New sticker widget - New alarm system - Widgets can be set to stay on top of other windows - Iconify options (menu item, ARexx, and startup) - Calendar: Switch back to the current month with MMB or Enter - Calendar: Scripts can be launched when clicking on dates - Calendar: ARexx commands for calendar event handling - RSS: Support for RSS enclosure element - RSS: Stripping of extra spaces in RSS texts - RSS: Added WArMUp and BoingsWorld Podcast RSS feeds - New example scripts for alarm and calendar - Incorrect compositing setting no longer leads to a crash - Other small changes Version 1.1: - Added safety checks for the compositing setting, as forcing the compositing mode on can cause crashes 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.