Awasu 3.0.1 (beta)

This is a beta release [?]. Some features may not be complete and the software may be unstable. Install at your own risk! You may need to do some basic computer maintenance tasks to get this release to run.



First, backup your existing Awasu installation! [?]

Then choose how you want to install this release:

Upgrade from Awasu 3.0 or 3.0.1.alpha1
Upgrade from Awasu 3.0.1.alpha2 or alpha3
Upgrade from a version of Awasu prior to 3.0
Create a clean installation
Reinstall Awasu 3.0.1


Awasu Server

Most of the work in this release has been updating the code base so that it can be shared between Awasu Server and the desktop version of Awasu. The functionality should remain the same, but some bugs may have been introduced by the code re-organization, so please keep an eye out for any odd or broken behaviour.

Please contact us if you are interested in running a server version of Awasu.


Awasu API

There are a slew of new functions:
$/stats Returns information about Awasu.
$/userInfo Returns information about the user account Awasu is running under.
$/logs/activity Returns the Awasu Activity log.
$/logs/error Returns the Awasu Error log.
$/channels/cleanup Returns channels that are eligible for cleanup.
$/channels/errors Returns the error log for channels.
$/channels/folders/tree Returns the channel folders in a hierarchial format.
$/channels/folders/create Creates a new channel folder.
$/channels/folders/delete Deletes a channel folder.
$/workpads/create Creates a new workpad.
$/workpads/update Updates the configuration for workpads.
$/workpads/delete Deletes workpads.
and other changes:

  • Upgraded the Python script for accessing the Awasu API.
  • Added a PHP script for accessing the Awasu API.
  • Completely reworked the HTTP engine for the Awasu API.
  • The Awasu API now supports compressed responses.
  • Awasu API arguments can now be specified in the HTTP POST data.
    Include a <apiArgs> node as a top-level child, with each argument as an XML attribute.
  • Changed the way Awasu responds if channel/report/workpad API's are called but no objects are selected.
    In particular, this means that $/channels/delete id=* no longer returns an error if there are no channels.
  • The Awasu API now recognizes @ to mean the default workpad when creating reports and channels.
  • Split the $/workpads/list functionality into $/workpads/list and $/workpads/get (these now work in the same way as the corresponding channel and report functions).
  • $/workpads/list now returns information about custom fields.
  • The channel GUID is now included in the output for API calls $/channels/stats and $/channels/list.
  • $/channels/list now returns the path to a channel hook's .HOOK file (not its script).
  • Custom fields are now included in the response for $/workpads/feed.
  • $/buildInfo now returns the build options (add a "verbose=1" parameter).
  • Tweaked the way $/buildInfo returns the expiry date (for expiring builds of Awasu).
  • $/stats now returns the number of channels currently updating.
  • $/channels/list now returns the number of new and unread items.
  • $/channels/list now returns the number of update errors.
  • $/channels/list now returns the channel GUID's.
  • $/channels/create now expects search channel score cutoffs to be between 0 and 1.
  • Changed the way a channel's auto-update enabled flag and interval are passed in and out of the Awasu API.
  • $/reports/list now includes the flag that controls whether the report post-processing command is visible or not.
  • {%BUILD-DATE%} and {%EXPIRY-DATE%} now respond to the standard timeZone=... and format=... parameters.
  • Awasu API request parameters are now decoded correctly.
  • Fixed the handling of special characters in search queries that come in via the Awasu API.
  • Stopped Awasu API responses from being converted to UTF-8 twice.
  • Awasu no longer responds to API requests when it is shutting down.
  • Awasu no longer exposes passwords in logs or API calls.
  • Awasu now uses a special token (generated each time it starts) in the cases where the token must be embedded in HTML (e.g. the search page).
  • The Awasu API token is now encrypted in CONFIG.INI.
    You will need to re-enter your API token in the Program Options dialog.
  • The outputFile= Awasu API parameter is now only recognized for requests submitted via the awasu:// protocol.
  • The Awasu API now falls back to XML format when returning an error for an unknown API request.
  • Added a muppet header to the $/stats and $/reports/list XML response files.
  • Added a new {%IS-SERVICE%} parameter to the $/buildInfo templates.
  • The JSON response for $/channels/cleanup now has a root node.
  • The JSON response for $/search/query and $/feedItems/get now return the text type for each text field.
  • Fixed a problem with how Unicode text was being returned in JSON responses.
  • Fixed errors in some JSON template files.
  • Added HTML templates for many API requests.
  • HTML template files are now marked as UTF-8.
  • The HTML template for $/workpads/list now links to each individual workpad.
  • The Awasu API now supports requests for a favicon.
  • The Awasu API no longer returns channels that are in the process of being deleted.
  • Tweaked some Awasu API error messages.


Other changes

  • Optimized the process of importing channels.
  • Removed the option to disable quick-subscribe when importing channels (this is now always on).
  • Fixed a problem when importing file-based channels that was setting their preferred display names to their URL.
  • Channel error logs are now persisted across sessions.
  • Awasu now fixes up the HTML when FTP'ing or emailing reports, changing references to local resources to links that will work from a remote browser.
  • User-defined metadata nodes are now stored in the archive database (not CONFIG.INI).
  • Added support for encode=href in templates (values are encoded in a way that's suitable for <a href="...">).
  • Added support for {%??...%} and {%!!...} in templates (the value must be present and have a boolean value of true/false).
  • Fixed a problem that was stopping ampersands from appearing in item titles.
  • Fixed incorrectly-generated links in search results for searches done within Awasu.
  • Informational messages about enclosure downloads are no longer recorded in the Error Log.
  • Added the ability to limit the number of items included in a report.
  • Removed the limit on search query lengths.
  • Stopped search results from being converted to UTF-8 twice.
  • Fixed a problem that was stopping negative search result filters from working.
  • Channel config files are now flushed to disk before channel hooks are invoked.
  • Channel hooks now receive the channel's home URL when being invoked.
  • Query parameters are now passed through to application plugins correctly.
  • Worked around a problem when there are multiple network cards with the same MAC address.
  • Awasu now sets the preferred display name when importing channels.
  • Fixed a problem where deferred search index updates could get lost if the update window ends while the update is in progress.
  • Worked around a UI hang when clicking on items if My Channels is set to show unread item counts and channels are showing "new items only".
  • Fixed a possible crash when dragging toolbars.
  • Fixed a problem that was stopping the Open channel context menu item in the Downloaded Files window from working.
  • Fixed a problem that was stopping error-mode channels being shown, even if "always show error-mode channels" is turned on, if a folder-based filter is active.
  • Fixed a problem that was occasionally causing deleted channels to appear in My Channels.
  • Fixed an occasional deadlock.
  • Fixed some internationalization problems.
  • The new items for a channel are cleared if the channel's summary page is requested via the API.
  • Added the MOTW to HTML and template files.
  • Added more information to the Awasu stats in the About box.
  • Toolbars are now locked in place by default.
  • Updated the crash handler to correctly identify newer versions of Windows.
  • Worked around a problem introduced by IE11 that was causing Awasu to get stuck updating channels, or not exit properly.
  • Pending channel updates are cancelled if a channel update blackout starts.
  • Optimized how Awasu checks if items have already been received.
  • Miscellaneous optimizations.
  • Minor UI changes.