Package README (CVS ver. 1.4)

About

    ATAudio is a Archetypes-based content type for storing audio files
on the file system. It's based on the ExternalExample provided by
Christian Scholz in his ExternalStorage product.

This product is being developed as part of the Plone4Artists project
(http://plone4artists.org). You are welcome to join in the development
and report bugs as you find them. See mailing list and bug reporting
section at the bottom of this README.

Usage

    Add a new audio file to your Plone site by choosing it in the "Add
new item" menu. You can then upload an audio file (typically an MP3
file) which is then associated with this object. The user can choose to
either download the audio file or listen to it, in which case it is
streamed to their media player.

When you upload an MP3 file, the artist, album, genre, year, etc.
metadata automatically populate the fields on the Plone edit form.
Likewise, when you edit the fields and click save, the ID3 tags are
written back into the MP3 file, so this metadata will appear in the
streaming player.

Before the streaming will work, you need to define the name of your
media server in 'portal_properties/ataudio_properties'

'media_server = media.domain.com'

There is a portlet that will display the 5 most recently published audio
files on your site. You can add this portlet to the left_slots or
right_slots property for a given folder, by adding this line:

'here/portlet_audio/macros/portlet'

There is also a 'viewlet_audio' for use with CMFContentPanels (or
standalone) which will display the 5 most recently published audio files
in the current folder and its subfolders.

Install

    Simply place the ATAudio folder in your Zope's Products dir, restart
and install in your Plone site using the 'portal_quickinstaller' tool in
the ZMI, or go to 'Plone Setup' -> 'Add/Remove Products'.

Dependencies

    See the 'DEPENDS.txt' for a list of products that ATAudio requires.

Bug reporting

    Please report any bugs you find and/or feature requests to
http://plone4artists.org/tracker/

Mailing list

    You can also subscribe to the Plone4Artists mailing list if you'd
like to participate in the discussions. Simply send a message to
plone4artists (at) jazkarta.com with "subscribe" as the subject.

Author

    Nate Aune (natea AT jazkarta DOT com)
natea on #plone IRC (irc.freenode.net)

See 'AUTHORS.txt' for a list of other contributors