Helix media activity
see more templates or propose new |
Description & Goals
Summary
Watch & Listen is a media player based on the Helix Media Engine. The Helix engine uses a plugin system to provide compatibility with a wide array of formats. By default Watch & Listen will ship with only free codecs, separate bundles are available for non-free codecs.
Currently, the activity is bundled with the Helix media engine all in one package for easy installation. Eventually this engine, and the python bindings providing access to it will be moved to a location allowing any activity to easily use the media engine.
Goals
Give children access to multimedia content
Licensing & Versions
This activity uses the Helix Media Engine. The Helix was formally known as RealPlayer until they released the code under the GPL and RPSL. All core parts of the Helix engine related to playback are released under the GPL and can be used royalty free. Most codecs are also released under the GPL. However, not all codecs are royalty free. RealNetworks has waived royalty fees for RealMedia codecs when used on the XO.
The default bundle will only include only Free codecs. For ease of use, bundles containing non-free codecs are available.
| Name | Description | Current Bundle |
| Free | Only free codecs | watch-listen-14.xo |
| RealMedia | Free codecs plus RealMedia codecs. | watch-listen-realmedia-14.xo |
| NonFree | All codecs that can be distributed by RealNetworks without royalty | watch-listen-nonfree-14.xo must be downloaded from HelixCommunity.org |
Supported Media Formats
Watch & Listen can play any format that has a Helix Plugin. Not all plugins are GPL and patent free. By default only the free codecs will be shipped. Packages including non-free codecs will also be available.
Free Codecs
All of these codecs are completely open source and patent free.
- Ogg Vorbis and Ogg Theora
- Uncompressed PCM from .wav, avi, .aiff or .au files and standard RTP streams
- PCM a-law and u-law from .wav, avi or .au files and standard RTP streams
- SMIL 1.0/2.0 multimedia
- Still images (JPEG, GIF, PNG, WBMP)
- Text - plain from .txt files
RealMedia Codecs
RealNetworks has waived royalty fees for RealMedia codecs when used on the XO.
- RealAudio/RealVideo Codecs
- RealAudio and RealVideo playback from RealMedia file format and RealMedia streams.
- RAM metafile parsing and playback
- RealEvents and RealImageMap from .rm files and RealMedia streams
- RealText from .rt files and RealText streams
Non-Free Codecs
Helix Plugins are available for these formats but they have patents associated with them.
- I420 video rendering
- MJPEG video playback from .avi files
- MP3 audio playback from .mp3 files, standard RTP streams and shout-cast streams
- MP3 playlist parsing and playback
- Helix MP3 Decoder
- Helix MP3 Encoder
- RGB video from .avi files
- H.261 video from standard RTP streams
- H.263 video from .3gp files and standard RTP streams
- MPEG1/2 file parsing
- MPEG4 audio (no video) playback from .mp4 or .3gp files and ISMA or 3GPP streams
- 3GPP-Rel6 file parsing and 3GPP-Rel6 audio and video playback
- 3G2 audio depacketizers and QCelp decoder hooks
- SDP file parsing
- TimedText from .3gpp files
Codecs That Can't Be Shipped
These codecs are supported by Helix engine but cannot be distributed because of the royalty costs or licensing.
- AMR-NB and AMR-WB audio playback from .3gp and .amr files and 3GPP streams
- H.264 video from .3gp files and standard H.264 RTP streams
- AAC and aacPlus decoder - More info
- AAC and aacPlus playback from .3gp, .m4a, .aac or .ra files and 3GPP, ISMA or ice-cast streams
Collaboration
Collaboration is not available with Watch & Listen at this time due to technical limitations. The collaboration scenario envisioned is multiple children viewing the same media in sync. The XO lacks the CPU power and bandwidth for this to be practical
Visual Design
Screenshots
This button toggles with play. Este botón se alterna con el juego.
|- |
This button toggles with No-repeat |- | |Progress bar |Shows the current time and total duration of the clip. Este botón se alterna con repetir-n | - | | Progress bar | Muestra la hora actual y la duración total del clip. You can also seek through a media clip by clicking and dragging. También puede buscar los medios de comunicación a través de un clip, haga clic y arrastrar.
|- |
Escape exits. Escape salidas.
|- |
Toggles with Native Size. Alterna con el tamaño original. |- | |Buffering/Stats |The text at the bottom displays buffering status, as well as title and author of the currently playing clip. | - | | Buffering / Estadísticas | El texto en la parte inferior muestra la condición de amortiguación, así como título y autor de la imagen se está reproduciendo. |} |)
Sample Media
- You can download a packet of videos to go along with it. If you're downloading something larger than 15MB, you should do it from the command line via wget; downloads via the browser currently go to /tmp and use up memory. Use the open location button (see below) to browse to these files. A good place to find some ogg videos to test with is wikimedia:
Tips and tricks
Running the Helix activity from the command line
It is often useful to directly launch the media player from the command line. In particular, many programs (web browsers, file managers, etc.) can be configured to use this command for opening media files, which does not work with sugar's activities. The command line tool can also be used directly to play streaming media by passing to it the URL of the media stream.
Follow the below steps to achieve that (note that, using a three-button USB mouse, you can paste selected texts to the terminal with the middle button):
- Install the Helix media activity as described above
- Open a terminal activity.
- Execute the following command:
nano helixplay
- In the text editor window, paste the following content (using the middle-button of your USB mouse after selecting this text in the browser window):
#!/bin/sh
#
# helixplay
#
# Runs the Watch & Listen Activity from the command line. A specified URI
# is used. The activity is run in the background.
#
# Usage:
# helixplay [URI]
#
# Example:
# helixplay http://www.radioparadise.com/musiclinks/rp_128-1.ram
#
# This script is basically a shortcut for the following command:
# SUGAR_BUNDLE_PATH=/home/olpc/Activities/Watch\ \&\ Listen.activity sugar-activity MediaPlayerActivity.MediaPlayerActivity -b org.osl.MediaPlayerActivity -a fakeactivityid -u [uri] &
SUGAR_BUNDLE_PATH=/home/olpc/Activities/Watch\ \&\ Listen.activity
_ACTIVITY=MediaPlayerActivity.MediaPlayerActivity
_BUNDLE=org.osl.MediaPlayerActivity
_ACTIVITY_ID=fakeactivityid
sugar-activity ${_ACTIVITY} -b ${_BUNDLE} -a ${_ACTIVITY_ID} -u $@ &
- Take care not to introduce line breaks when copying. Afterwards, press CTRL+X and confirm the file safe.
- Execute the following command to make that file an executable script:
chmod 775 helixplay
This finishes the setup. You can test the activity by executing
./helixplay http://www.radioparadise.com/musiclinks/rp_128-1.ram
(or whatever radio you like). If you followed the above steps, your file helixplay now resides in our home directory (/home/olpc/). The full path is needed to launch the program from another application.
Playing streaming media in web browsers
After enabling the command-line execution of helix, it can also be used as a streaming media plugin in the Opera web browser, so that you can just click on stream URLs to play them, as usual. To do that, first install the Helix command-line script as described above, and install Opera as described on its page in this wiki. Once Opera has been installed, you need to configure the streaming audio player:
- Click the O in the upper-left hand corner of the screen.
- Go to Tools\Preferences\
- Click the "Advanced" Tab
- Click "Downloads"
- Click the "Add..." button.
- Enter "audio/x-pn-realaudio" under MIME type (do not enter the quotes)
- Enter "ram,ra" under "File extension(s)"
- Click the radio button to the left of "Open with other application"
- Enter the following data in the text box beneath "Open with other application": /home/olpc/helixplay
- Click the check box next to "Pass web address directly to application".
- Click OK twice to close all dialogs
Clicking on a real media stream URL should now launch the Helix player to play it. In addition to real media streams, you can also configure further content types to be played with Helix. In general, it might often suffice to click on a new media type: Opera then asks you what to do with it and you can use similar settings above.
Development
Feature Requests
- Key bindings - require changes to the helix engine to be made upstream.
- a two second "It works" ogg recording
- Translated Pages
- Activities
- Core
- XO source
- Test plan wanted
- POT wanted
- Mimetype application
- Mimetype ogg
- Mimetype audio
- Mimetype video
- Mimetype x-wav
- Mimetype x-vorbis+ogg
- Mimetype x-flac+ogg
- Mimetype x-speex+ogg
- Mimetype x-theora+ogg
- Mimetype x-ogm+ogg
- Mimetype image
- Mimetype gif
- Mimetype jpeg
- Mimetype png
- Mimetype AMR
- Mimetype ram
- Mimetype 3gpp
- Mimetype mpeg
- Mimetype mp4
- Mimetype x-adpcm
- Mimetype vnd.rn-realaudio
- Mimetype vnd.rn-realvideo
- Template limit reached
- Mimetype
- Activity bundle
- General Public
- Developers
- Sugar
- Software
