Social Media Download Manager for the MUSE 3 Platform.
RawMaterials is a standalone Mac OS X application that downloads social media assets (photos, video, microblog/SMS text, etc) from the SIFT channels. It allows for some client-side management of the downloading process. Users are able to filter out items that they do not want to download. To control these filters, there is a GUI that launches along with the application. A remote application can also send OpenSoundControl (OSC) messages to a control port. This can be any application that knows how to talk OSC.
Thus, an artist would start by creating channels on SIFT that collect images/videos/SMS/etc. These assets are download by RawMaterials and cached locally on disk. Then your PureData, Processing, Max/MSP or other application would receive messages about the assets via OSC. We provide here as well a plug-in for the VJ software Modul8.
The RawMaterials application version 0.4.3 for Mac OS X 10.4 or later (29MB)
(also contains the Modul8 plug-in)
If you are upgrading from a former version, you should remove the contents of the
~/Documents/rawmaterials folder. (where "~" is your Mac OS X user name)
The current version is 0.4.3. It currently supports the following media formats:
* Livecast live video streams
* Video files (mov, mp4, mpeg, photo-JPEG and more)
* Youtube MP4 videos
* Text items (SMS, emails, Twitter posts, microblog posts, etc.)
* Images (JPEG, BMP, GIF, PNG)
* Flickr images
Installation The Modul8 plugin must be installed to the /Applications/Modul8/Modules/ folder. The RawMaterials.app application must be installed in the /Applications/ folder. Usage * Log in to http://developers.mobilemuse.ca/ with your MUSE 3 user name. * Create a Mobile Dialog dialog if you want to support SMS and MMS. * Create a Sift Tool Aggregator channel with a keyword. * Connect it to the Mobile Dialog dialog you created. * You can also create Livecast events under you user name. * Start the RawMaterials application. * Provide your MUSE 3 user name in the graphical user interface.
* Check the SIFT channels that you want to enable. * You should messgages in the log window saying that the assets are being downloaded. * Check the Livecast events that you want to enable. * Enable individual Livecast streams (on the right) by selecting them. (in blue) * Start your client application. (such as Modul8.app with the RawMaterials.m8m module) * The list of downloaded assets should be communicated to your client application.
Quicktime settings If you plan to use Livecast streaming on a Mac OS X computer, you need to change some Quicktime settings : * Open the Quicktime Player.app application.
* In the Quicktime Player menu, choose "Quicktime preferences..." * In the preferences window that appear, choose the Streaming tab. * Uncheck the "Enable Instant-On" option.
Offsets in the Modul8 media set In the RawMaterials Modul8 module window, you can change the number of assets for each type (video, image, live streams) and their offset where they appear in the media set. In Modul8, the media set has 8 tabs, and each of those tabs have 16 slots for assets. The default settings are : 16 slots for videos in the tab 1, 16 for images in tab 2 and 16 for live streams in tab 3. The indices of the slots in the media set start at 0 such as tab one contains slots 0 to 15, and tab 2 contains slots 16 to 23, etc.
Indices of the first slot for each tab in the Modul8 media set.
| Tab number | Offset |
|---|---|
| 1 | 0 |
| 2 | 16 |
| 3 | 32 |
| 4 | 48 |
| 5 | 64 |
| 6 | 80 |
| 7 | 96 |
| 8 | 112 |
Troubleshooting If you have problems running the application, please write to the MUSE developers mailing list. You should provide the contents of the ~/Documents/rameterials/system/log folder as well as the Console error stack trace, if available. (where "~" is your Mac OS X user name)
Please subscribe on the mobile muse developers mailing list to stay tuned.
Here is a diagram that explains the relationships between the RawMaterials application and the other MUSE 3 Platform components.
The RawMaterials documentation page contains links to some PDF documentation and plans concerning the Raw Materials project and specific information and documents set-ups to be able to better understand and use the Raw Materials Application and Modul8 Module. It should also help the user to set-up it's performance and try to answer questions.
OSC Messages RawMaterials uses the OpenSoundControl protocol to communicate with client applications. The following OSC messages are expected on port 31337 by the RawMaterials application. For each message, the application should answer some OSC messages on port 31338. /channel/list /items/list /mobilemuse/connect "string:username" You can read the full list of OSC tags in the RawMaterials OSC Documentation page. Subversion Version Control Repository If you want to know which OSC messages are implemented, you can ask on the mailing list, or you can look direclty in the code. To do so, you should check out the SVN repository from https://svn.sat.qc.ca/rawmaterials and look in the RawSiftAggregator.py file under the _setupOSC() method. Each OSC handlers are defined there. RawMaterials is written in Python 2.4. You can browse the SVN repository using our Trac web site. Pure Data Examples We made a few Pure Data patches. You can download them all directly from the Subversion repository.