I wish I could read the readme, but it is unreadable even after word wrap gives me long lines.
I have made some comments/questions inside your instructions, perhaps it is useful for the readers and certainly for me if you can answer them. As I have no working streaming from my master streamer, it may be my additions are mistaken but I have taken all information from this thread.
INSTALLATION:
Basic Setup (MASTER):
0) Enable script support and control of XBMC via HTTP
For use on Win7 enable script support:
http://www.tech-recipes.com/rx/2513/powe...t_support/
For use on W-XP ...install a powershell from here link ...
If you have not properly installed the powershell, you will get an sendUDP.PY error message on booting XBMC and XBMC may not exit properly.
On your master XBMC:
System > Network > Services > Allow Control of XBMC via HTTP and set the port to 8080
1) Install the plugin via Add-ons directory
2) Configure the plugin by selecting the path to your vlc executable
Windows: browse to your vlc.exe
XBMC Linux: what should be the path, should VLC be installed manually?
XBMC Live: what should be the path, should VLC be installed manually?
3) Configure the path for the generated pls files (usually /home/<username> for linux users and C:\Documents and Settings\<username>\My
Documents respectively for Windows users
4) IP or Multicast Address - You can leave this at the default but if you plan on having the ability of streaming at one point from any box make sure
that each box has a different Multicast IP and Port so that their is no overlap in the broadcast domain. Lets leave it for now at the default of
224.1.1.152
With this setup you could define a source for each on every box and tune into what is playing at any given time from anywhere in the house... starting to see the picture?
5) UDP/TCP Port: As mentioned before, this coincides with the above but lets leave it for now
6) SAP Name - Put a meaningful name with NO spaces for the SAP name
7) As this is the MASTER, then check the Global Master and Dedicated Streaming Server.
DEFINE MASTER, GLOBAL MASTER AND DEDICATED
8) Start Streamer on Startup: For Global Master (Master) select this box.
9) Again if this is a dedicated Master, then change the Default Video Player to MR-Video_Stream, leave the Default Audio Player as PAPlayer
??SEEMINGLY CONFLICTS with??
In the plugin settings - (For Windows only) select the default audio player as MR-Audio_Stream (only if this is the master). Unlike the linux variant where you have the ability to select "MAV Mulicast Sink" as the default audio output device which is how the audio is virtually piped to the streamer for broadcast, we have to hand feed the media to the streamer.
10) The defaults for the rest should be satifactory
11) Select OK to save the settings.
12) Goto the plugin and select Generate Files
13) Enable audio output on the streaming server
Win 7: Go to the plugin and select Loopback (audio will be reproduced internally on vlc)
Linux: Goto System > System > Audio output > Audio output device and select MAV Streaming Sink (Linux Only) Audio will be produced via the Loopback
14) Because this is the initial setup of the plugin a full Restart of your machine and XBMC is required.
Note: from here on out, any changes made to the Addon Settings will require a restart of XBMC only so that new playercorefactory.xml file can
be re-initialized. IT'S also a good idea to RE-GENERATE FILES everytime you make a change to the settings.
XBMC Client Setup:
1) Configure your paths.
2) Configure the SAP Name of the Client.
3) Dedicated Stream Server: enable when this is a windows based XBMC client.
3) Goto Misc Settings and select Auto Start Playing Source if you want this Client to automatically start playing the Master Source when the master starts streaming.
NOTE: If you are already playing any media on the client the Master will not activate the source on the client.
4) Select OK to save the Settings
5) Select Generate Files.... Requires a XBMC restart.
RESTART XBMC
6) Adding Sources:
Adding sources needs to be done on each client for Music streams and for Video streams in order to enable the client to pickup and play or autoplay the streams in the network that are broadcasted by the master(s).
To add a source now is very easy, in the MultiroomAudio plugin via the Context menu select "Add New AV Source", a dialogue will popup and now select "Auto Scan".
IS THIS THE SAME FOR LINUX/WINDOWS SYSTEMS?
I cannot find the context menu. Do you mean Music / Add source / Browse / SAP streams, is that what you mean
From here it will automatically find the Master and any other possible MAV Clients on the network, provided they were initially configured and restarted. ;-)
Now that you restarted XBMC on your client
7) What is playing: Install client-initiated access to the broadcasted streams
Everytime you create a new streaming source on your client (remember, each master is a streaming source with its own streaming address) a .pls file is generated and stored in the Multiroom-AV folder of the client. In that folder there are always two subfolders name VIDEO and AUDIO.
Now, what you should do is go into the Music and the Video sections of the XBMC Client under "Files" and do "Add source" to add the VIDEO folder to the Video Section and AUDIO folder to Music. When you get to the point where you give the new item a name, for both instances call it Multiroom-AV and hit OK to save. So, What are we doing here...? Well, by doing this (ONLY ONCE) we will have the ability to access the sources via something like the XBMC Remote for iPhone or http....
You should be good to go:
Usage:
To use the plugin lets say to stream a video throughout the house...
1) Goto the MultiroomAudio plugin and activate the Localhost client (created earlier)
IS THIS STILL VALID IN THE CURRENT VERSION? WHAT LOCALHOST CLIENT? DO YOU MEAN under Programs / MultiroomAudio / START STREAMING ( in case this was not already enabled in Start Streamer on Startup )
Play a stream
2a) In the plugin (Programs), select Loopback if you wish to listen to or see the broadcasted stream on the streaming server too.
2b) Once activated, now goto your video section and navigate to a video that you want to play/stream... select the context menu for the item and select "play using" and choose Video_Stream.... viola! now you are streaming video throughout the home
3) You can now go to other XBMC's and use the plugin loaded on them to listen in, provided that you have created a source to use. ;-)
4) If you want to test if the Master is streaming properly without a XBMC as a client, use any Windows machine with VLC as follows:
Start VLC, select Media / Open Network Stream and enter the network address UDP://@224.1.1.152:1152
As soon as your client VLC detects a stream it will play.
You can use the same process described above for music as well. At this time, the plugin only supports streaming one media file at a time unless you create a playlist and use that to pass onto the streamer using the "play using"
BTW... it's not recommended to stream from a wireless sourced pc and it has been experienced that multiple multicast streams can put a heavy burden on your wireless network.
check out the readme for more info.
Enjoy!