PocketRSS version 2.1 *************IMPORTANT***************** If you were using PocketRSS v2.1.2 or earlier, and you want to migrate your existing PocketRSS databases, you will need to use the PRSSConverter.exe utility before you install this new version of PocketRSS. If you do not want to use the PRSSConverter.exe utility, you may also create PocketRSS Backup files (*.prbk) before you install this new version. The new version of PocketRSS can still consume earlier PocketRSS Backup files, but will not support the *.prdb databases. *************IMPORTANT***************** support@happyjackroad.net *NOTE: a complete set of Help files are located on the PocketPC after installation. To access Help, on PPC, Start->Programs->PocketRSS, main menu "Help" Sections --------------------- 1) About 2) Installation 3) Configuring 4) Uninstalling 5) Known Limitations 6) Version changes ----------------------------- 1) About ----------------------------- PocketRSS is a Today Screen plugin and stand-alone application which allows a quick and easy method of displaying various types of RSS/OPML compliant data on your Today Screen. It does require a connection to the Internet from the PocketPC, but is designed to still function while offline. PocketRSS is designed to run on a PocketPC 2002/2003 device that has an internet connection. This means that your PocketPC must have one of the following... - a wired LAN card - a wireless LAN/WAN card - a modem card - a bluetooth connection to an internet enabled device - or is a PocketPC 2002/2003 device using ActiveSync's Pass Through connection ----------------------------- 2) INSTALLATION ----------------------------- To install PocketRSS, simply run PocketRSS.exe from your Desktop (file name may vary based on version). If performing a reinstall, you can simply use the new installer to perform the reinstall. Once installation is complete, PocketRSS will consist of a several critical files... - will install ADOCE dlls in the Windows directory - will install PocketRSSToday.dll (approx. 370KB) in Windows directory - the remaining files can be installed in the default directory (\Program Files\HappyJackRoad\PocketRSS) or you may opt to install in another location. - PocketRSS is now using the Pocket Access database format for data storage. ----------------------------- 3) CONFIGURING ----------------------------- - To Configure the PocketPC device(after installation)... - On your PocketPC, goto Start->Programs->PocketRSS - To Configure Network Settings: main menu, "Network Connection" - To Configure Today plugin and other settings: main menu, "PocketRSS Settings" - To Create/Open a Database: main menu, "RSS Database" - To Add new Feeds: main menu, "Feed Wizard" ----------------------------- 4) UNINSTALLING ----------------------------- To uninstall PocketRSS, do the following steps... 1 - From Desktop, Open ActiveSync, select Tools|Add/Remove Programs from menu 2 - Select PocketRSS to remove from your PocketPC device. ------------------------------ 5) Known Limitations ------------------------------ - Requires connection to internet(from device) to download data via ActiveSync or a Network card. - Might take a minute or so for connection to timeout when trying to connect to a web server that is running slowly. - Might not work with all types of proxy servers. ----------------------------- 6) Version changes ----------------------------- 2.1.7 - new: allow selection of Media Player application - updated: added support for WM 5.0 devices - updated: added support for iTunes podcast feeds - fixed: removed Html popup menu that did not function properly - fixed: MessageBox size for square screens during installation 2.1.6 - new: added support for Atom 1.0 - updated: added additional Audio download error messages - fixed: parsing of Atom 0.3 with embedded xml content - fixed: parsing of xml attributes with mixed usage of single and double quotes - fixed: locked file after a download is cancelled 2.1.5 - important: database changed from Pocket Access database to sqlite open source database - new: ability to set the internet connnection timeout, to help with GPRS connections - fixed: prevent device from powering down while downloading - fixed: background download failures do not require as frequent user interaction - new: Auto-Register ability for performing PocketRSS Registration 2.1.2 Today plugin... - new: collapsed Headline only mode - new: ability to set Headline text color - new: added support for PocketBreeze Left-Handed scroll mode - new: ability to reload only the Feeds for the active view - new: ability to set an "Auto Read" mode - updated: ability to set height as small as 30 pixels - fixed: "Mark As Read" did not always mark the correct item in List mode Main app... - new: Auto Reload option for OPML Subscriptions - new: ability to mark all items of a Feed as read from RSS mode - new: ability to disable "cached" internet connection handle (for users having networking problems) - fixed: unread totals now display updated values correctly as you read items - fixed: rebuilding of subscriptions now preserve PocketRSS settings for matching Feeds 2.0.23 Today plugin... - added startup delay when dll loads to let any plugin image time to load from a storage card - added ability to mark items as "read" - "read" items are now greyed when in list mode Main App... - fixed: deleted items now remain deleted even if you reload the same feed again - fixed: purge all data now also removes any linked audio data files - fixed: formatting issue of some feed data when displaying item description data - fixed: incorrect date parsing for some feeds - new: item icons to signify if an item has description data, extended data, or audio data - new: status icons for audio data to signify if data is: queued for download, available for listening, or unavailable - new: popup menu for audio item options - new: ability to "download now" for an audio item - new: special "Audio Data" and "Extended Data" Views - new: ability to restrict number of audio items per feed - new: display of unread/total item counts in listings - new: ability to hide all items that do not contain description data (ie. it only has a headline title) - new: ability to compact the database - new: ability to set a number of automatic retries if a download fails - new: download status indicator showing number of KiloBytes downloaded - updated: help for Audio/Podcasting usage 2.0.18 Today plugin... - now aware of the PocketBreeze "Using VGA hack software" Setting - now uses PocketBreeze "text_color.bmp" for setting the view button text color - fixed the WebLink not launching the user-specified browser defined in PocketRSS Settings - plugin images can now be "skinned" even when not using PocketBreeze - added a registry "hack" to allow proper headline rotation when using software like PPX Main App... - added Tap-n-Hold menus to RSS mode and View mode lists - added ability to hide the RSS and View mode button bars - speed up screen redraw for the RSS and View mode lists on non-VGA devices - added ability to force PocketRSS to only retain most recent feed data for all Feeds (PocketRSS Settings, General section) - xml tag parsing is now case-insensitive (this should fix some OPML files that would not import) - single tap on status image in left column for RSS or View mode now emulates a double-tap event - modified duplication checking. Previously if GUID was not available, feed item date was used. Unfortunately, some Feeds contained the same date for all their contained items, and as a result, PocketRSS would only display one or two of the items in the feed. Now if GUID is not available, item date and item title are used to check for duplicates - fixed the failure of a Feed that recently had "Extended Data" enabled, not always downloading the extended data on the next Feed update event. 2.0.17 - fixed poor rendering quality of Fonts in main application for VGA devices - fixed bug that prevented PocketBreeze users from using VGA skins within PocketRSS 2.0.16 - increased limits on Audio Content file sizes - ability to remove WebLink on Today plugin - ability to change the action of the WebLink on Today plugin - one tap list/details toggle on Today plugin - enabled automatic VGA checking as part of installation - enabled ability to drag scrollbar on Today plugin - added additional larger font when using VGA hack software on Today plugin 2.0.15 - ability to use Today Screen plugin within PocketBreeze - database storage for faster feed viewing/searching/history archiving - simple Feed content management - namespace/xml mapping feature for advanced users - custom view modes (including dynamic, keyword-based views) - Feed Wizard to easily add/find new RSS Feeds - support for "stylus-free" viewing (D-pad optimized) - feed item control (read,unread,locked,delete,etc.) - ability to download full article links for offline viewing - ability to download audio content (aka podcasting) - ability to integrate with PocketBreeze - support for WM2003 SE landscape mode (and VGA) - improved network connections - overall new "look-n-feel" 1.42 - fixed failure to share hardware navigation control with other active applications. - added ToolTips for Toolbar items. 1.41 - added fix for parsing international character sets not encoded with UTF-8. 1.40 - support for ATOM v0.3 syndication format. - support international character sets encoded in UTF-8. - use of hardware navigation control in article viewer mode. - new AutoReload events: ActiveSync detection, user-defined scheduled times. - ability to set cache folder. - updated Today Screen icons and menu management. - disabled automatic attempt to reload data when simply switching to view a new source on Today Screen. - better support for when a feed source does not have a title. - ability to cancel a reload event on Today Screen. - fixed failure to switch to PocketRSS when minimized on WM2003 devices. - fixed handling for when corrupt webdata is found. 1.30 - updated RSS management mode. - alpha sorted. - group/Sub-group organization. - list font sizing. - drag-n-drop organization of sources. - new article viewer mode. - alpha/date/priority sorting. - read/unread filter. - article expiration filtering. - import generic OPML subscription files. - FeedDemon, NewsDesk, RSSBandit, SharpReader, etc. - export PocketRSS sources as OPML subscription. - better support for ill-formed RSS data. - display of Source/Article dates. - third-party browser support on Today Screen. - limit number of items per Source on Today Screen. - single or multiple source viewing on Today Screen. 1.21 - added support for feeds with embedded CDATA. 1.20 - added support for non-standard ABC News 0.93 feeds. - fixed ability to delete broken feeds. 1.11 - added support for PocketPC 2003 devices. 1.10 - added support for Importing a Radio Userland OPML subscription listing - added support for third-party browsers 1.03 - added support for OPML 1.1 feeds 1.02 - added support for longer URL entries - added support for RSS 2.0 feeds 1.00 - initial public release of PocketRSS Test environments... Device: Compaq iPaq 3600, 3800, 2200, rx3100 series and Dell x50v Active Sync version: 3.5 and 3.7 PocketPC OS version: 2002, WM2003, WM2003SE