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 feeds, sticker, and weather.
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
- SSL support for Pictures and RSS widgets requires installation of AmiSSL v4
(http://aminet.net/search?query=AmiSSL)
- To start the program at boot time, add the following line to the
SYS:S/user-network-startup file (and change the path to your location):
Run >NIL: SYS:Applications/RNOWidgets/RNOWidgets -skipplugins=* -delay 2
(the -skipplugins argument saves some memory if you have other Hollywood
plugins installed on your system)
USAGE
-----
General:
- Use the pull-down menu or keyboard shortcuts to select which widgets are
visible
- The "Snapshot windows" (command-.) menu item saves widget sizes, positions,
and its state if a widget is shown or hidden
- All widgets are freely re-sizeable from the bottom right corner
- All widgets are freely moveable from top of the widget
- The "Edit alarms" (command-e) menu item opens the alarm editor window
- Alarms work globally, so they aren't 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 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" sign or by pressing the Ctrl+Del
combination
- Notes can be browsed with the mouse wheel or with the page up/down keys
- 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
RSS feeds widget:
- Clicking a feed item will open the full story on a browser
- Different feeds can be browsed with the mouse-wheel, or by 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
- "r" and "enter" keys do a forced refresh for the feed
Weather widget:
- Widget's layout is dynamic so any resizing it wider alters its arrangement
- 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
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 RSS widget type in the Shell:
SetEnv SAVE RNOWidgets/rss 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).
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):
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, but by omitting the
"-" prefix.
Example:
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
RSS NEXT . . . . . . . . - Shows the next feed
RSS PREV . . . . . . . . - Shows the previous feed
RSS NEXTPAGE . . . . . . - Shows the next page of a feed
RSS PREVPAGE . . . . . . - Shows the previous page of a feed
RSS PAUSE . . . . . . . . - Pauses the automatic cycling of the feeds
RSS REFRESH . . . . . . . - Forces a feed to be re-loaded
RSS 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,
RSS, STICKER, or WEATHER.
Example:
RXCmd RNOWIDGETS "TOGGLE NOTES"
HISTORY
-------
Version 1.4:
- Added SSL support for network enabled widgets (requires AmiSSL v4)
- Added CXKEY (global hotkey) option to iconify/un-iconify 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, because 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, because forcing the
compositing mode on can cause crashes.
WEB
---
- Please visit http://jpv.wmhost.com/jpv_software/ for screenshots, support,
donations, and other software
- This program is made with Hollywood: http://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 software is made available to you as Donationware. If you use this
software, please make a PayPal donation to the author.
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>