Difference between revisions of "Streamer"

From AwkwardTV
Jump to: navigation, search
(Initial Revision)
 
(status change)
 
(59 intermediate revisions by 13 users not shown)
Line 1: Line 1:
 
{{Template:Banner}}
 
{{Template:Banner}}
 
Streamer README<br>
 
Streamer README<br>
Version 0.1.0 (ALPHA)<br>
+
Version 0.1.2 (ALPHA)<br>
11th May 2007<br>
+
20th October 2007
  
Download: http://www.dakaix.com/streamer/streamer-0.1.0.tar.gz
+
'''Does not work with Apple TV take 2 software.'''
  
© 2007 Dakaix & [http://alanquatermain.net Alan Quatermain]. All Rights Reserved.
+
Download: http://www.dakaix.com/streamer/streamer-0.1.2.tar.gz
 +
 
 +
© 2007 Dakaix & Alan Quatermain. All Rights Reserved.
  
 
== Description ==
 
== Description ==
Streamer provides the ability to listen to Internet Radio through your AppleTV. It works by acting as a wrapper for [http://www.mplayerhq.hu MPlayer] (the popular Unix media player). Additional functionality has been planned, and will be introduced in new versions.  
+
Streamer provides the ability to listen to Internet Radio through your AppleTV. It works by acting as a wrapper for MPlayer (http://www.mplayerhq.hu - the popular Unix media player). Additional functionality has been planned, and will be introduced in new versions.  
  
 
Want to suggest a new feature? Contact either Dakaix or Alan Quatermain on the AwkwardTV IRC Channel (irc.moofspeak.net #awkwardtv).
 
Want to suggest a new feature? Contact either Dakaix or Alan Quatermain on the AwkwardTV IRC Channel (irc.moofspeak.net #awkwardtv).
  
 
See http://wiki.awkwardtv.org/ for more details.
 
See http://wiki.awkwardtv.org/ for more details.
 +
 +
== Screenshots ==
 +
 +
http://www.dakaix.com/streamer/Home_s.png
 +
http://www.dakaix.com/streamer/Front_s.png<br>
 +
http://www.dakaix.com/streamer/Text_s.png
 +
http://www.dakaix.com/streamer/Playing_s.png<br>
  
 
== Installation ==
 
== Installation ==
1. Extract the files from the .tar.gz, and copy the mplayer binary to: <code>/usr/bin</code> on your AppleTV
+
Streamer can be installed via the AwkwardTV Loader. Simply choose AwkwardTV from the AppleTV Menu, then choose Streamer from the list provided.
  
2. Copy Streamer.frappliance to this folder: <code>/System/Library/CoreServices/Finder.app/Contents/PlugIns</code> on the Apple TV.   
+
== Manual Installation ==
 +
1. Extract the files from the .tar.gz.
 +
 
 +
2. Copy Streamer.frappliance to this folder: /System/Library/CoreServices/Finder.app/Contents/PlugIns on the Apple TV.   
  
 
3. Restart Finder.
 
3. Restart Finder.
 
Use this command, which will kill Finder - it should restart itself automatically however.
 
Use this command, which will kill Finder - it should restart itself automatically however.
  
<code>kill `ps ax|grep [F]inder|cut -b 2-5`</code>
+
kill `ps ax|grep [F]inder|cut -b 2-5`
  
If you have the drive installed in the Apple TV, you will likely have to mount the root partition as read-write (using <tt>sudo /sbin/mount -uw /</tt>) to copy it. The command <tt>sudo /sbin/mount -ur /</tt> will reverse the above action.
+
If you have the drive installed in the Apple TV, you will likely have to mount the root partition as read-write (using sudo /sbin/mount -uw /) to copy it. The command sudo /sbin/mount -ur /will reverse the above action.
  
 
== Usage ==
 
== Usage ==
Line 31: Line 43:
  
 
== Release Notes ==
 
== Release Notes ==
 +
0.1.2 - ALPHA - 20th October 2007
 +
* New Program Icon
 +
* AppleTV v1.1 Support.
 +
 +
0.1.1 - ALPHA - 14th May 2007
 +
* Simpler Installation, no longer need to copy MPlayer to /usr/bin.
 +
 
0.1.0 - ALPHA - 11th May 2007
 
0.1.0 - ALPHA - 11th May 2007
 
* First release
 
* First release
Line 40: Line 59:
 
* Ability to Pause the Stream
 
* Ability to Pause the Stream
 
* Community Stream Directory (So that everyone can post their own streams and favourites).
 
* Community Stream Directory (So that everyone can post their own streams and favourites).
* Use media parades for folders without explicit cover art?
 
* Non-video playback support?
 
  
 
== License ==
 
== License ==
The MPlayer Binary is included under the GNU Public License, however the Streamer plugin is free for anyone to use - although please do not redistribute it without first seeking permission from Dakaix.
+
The MPlayer Binary is included under the GNU Public License, however the Streamer plugin is distributed under a Creative Commons Attribution-No Derivatives License. You are free to use and redistribute this work, but may not alter, transform, or build upon it. In addition, you must include the following disclaimer:
 +
 
 +
Portions Copyright (c) 2007 AwkwardTV
 +
 
 +
For license details, see:
 +
http://creativecommons.org/licenses/by-nd/3.0/
  
For source and more information on MPlayer, go to [http://www.mplayerhq.hu http://www.mplayerhq/hu].
+
For source and more information on MPlayer, go to http://www.mplayerhq.hu.
  
 
== Support ==
 
== Support ==
Line 52: Line 74:
  
 
== Donations ==
 
== Donations ==
If you wish, you may donate to Streamer via PayPal [https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=donate%40dakaix%2ecom&item_name=Streamer&no_shipping=1&no_note=1&tax=0&currency_code=GBP&lc=GB&bn=PP%2dDonationsBF&charset=UTF%2d8 here].
+
If you wish, you may donate to Streamer via PayPal using this link:
 +
[https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=donate%40dakaix%2ecom&item_name=Streamer&no_shipping=1&no_note=1&tax=0&currency_code=GBP&lc=GB&bn=PP%2dDonationsBF&charset=UTF%2d8/ Paypal Donation]
  
 
== Notice ==
 
== Notice ==
Line 59: Line 82:
  
 
The authors are not affiliated with Apple, Inc.
 
The authors are not affiliated with Apple, Inc.
 +
 +
[[Category:Plugins]]

Latest revision as of 21:27, 9 June 2008

<Google>WIKI</Google>

Streamer README
Version 0.1.2 (ALPHA)
20th October 2007

Does not work with Apple TV take 2 software.

Download: http://www.dakaix.com/streamer/streamer-0.1.2.tar.gz

© 2007 Dakaix & Alan Quatermain. All Rights Reserved.

Description

Streamer provides the ability to listen to Internet Radio through your AppleTV. It works by acting as a wrapper for MPlayer (http://www.mplayerhq.hu - the popular Unix media player). Additional functionality has been planned, and will be introduced in new versions.

Want to suggest a new feature? Contact either Dakaix or Alan Quatermain on the AwkwardTV IRC Channel (irc.moofspeak.net #awkwardtv).

See http://wiki.awkwardtv.org/ for more details.

Screenshots

Home_s.png Front_s.png
Text_s.png Playing_s.png

Installation

Streamer can be installed via the AwkwardTV Loader. Simply choose AwkwardTV from the AppleTV Menu, then choose Streamer from the list provided.

Manual Installation

1. Extract the files from the .tar.gz.

2. Copy Streamer.frappliance to this folder: /System/Library/CoreServices/Finder.app/Contents/PlugIns on the Apple TV.

3. Restart Finder. Use this command, which will kill Finder - it should restart itself automatically however.

kill `ps ax|grep [F]inder|cut -b 2-5`

If you have the drive installed in the Apple TV, you will likely have to mount the root partition as read-write (using sudo /sbin/mount -uw /) to copy it. The command sudo /sbin/mount -ur /will reverse the above action.

Usage

Once you have restarted Finder, a new option will be listed "Streamer" - this is the interface you will use when listening to Internet Radio.

Release Notes

0.1.2 - ALPHA - 20th October 2007

  • New Program Icon
  • AppleTV v1.1 Support.

0.1.1 - ALPHA - 14th May 2007

  • Simpler Installation, no longer need to copy MPlayer to /usr/bin.

0.1.0 - ALPHA - 11th May 2007

  • First release

Plans

  • Recent Streams
  • Displaying details about the stream (Name, Owner, Duration, Position etc.)
  • Progress Bar
  • Ability to Pause the Stream
  • Community Stream Directory (So that everyone can post their own streams and favourites).

License

The MPlayer Binary is included under the GNU Public License, however the Streamer plugin is distributed under a Creative Commons Attribution-No Derivatives License. You are free to use and redistribute this work, but may not alter, transform, or build upon it. In addition, you must include the following disclaimer:

Portions Copyright (c) 2007 AwkwardTV

For license details, see: http://creativecommons.org/licenses/by-nd/3.0/

For source and more information on MPlayer, go to http://www.mplayerhq.hu.

Support

For support please use the IRC channel. Please do not contact us via e-mail for support with the plugin. Thanks :)

Donations

If you wish, you may donate to Streamer via PayPal using this link: Paypal Donation

Notice

This program is provided at your own risk. The authors claim no responsibility for any damage or other outcome that may occur from use of this software.

The authors are not affiliated with Apple, Inc.