Stream-2-Stream's multicast+ is the next generation of streaming.


Installation
-----------------------------------------------------------------------------------------------
# You need the Java Runtime Environment (JRE) in order to run Stream-2-Stream.
Get it here:  http://java.com/en/download/manual.jsp


How to start
-----------------------------------------------------------------------------------------------
# Double click on client.jar to listen to a stream.

# Double click on server.jar to broadcast a stream.

On the first time started, a bandwidth test will begin.  
Please be patient during this time.  

If the bandwidth test does not complete, you can try again by going to
Settings->Options->Network then clicking on |Test Bandwidth (sets fields below)|



					Bandwidth
***********************************************************************************************
*
*Unverified - LAN USE
*----------------------------------------------------------------------------------------------
*
******* NOTE:  These numbers can be anything specified.  
*       It is recommended to use unverified on networks other than the internet (LANs).
*       Do not use unverified over the internet, people can lie or be clueless about their 
*       bandwidth.
*
* 
* # Upload - Can be any floating point negative or positive. >=0 represents bandwidth in KB/s.  
*   < 0 represents children that can be served(e.g. -3 will serve up to 3 children).  Negatives 
*   will be rounded down to integers.
*
* # Download - Similar to upload
*----------------------------------------------------------------------------------------------
*
*				
*	
*Verified - INTERNET USE
*----------------------------------------------------------------------------------------------
*
******* Testing bandwidth stops users from lieing about there bandwidth and helps users
*       who don't know about bandwidth.  Only clients on the internet and clients on the 
*       same internet connection as the server can connect (loopback clients).  Loopback
*	  clients are in a separate tree and do not take up any of the servers designated bandwidth.
*
*
* # Verified Maximum Upload - The maximum amount you can upload, tested by the speed tester.
*  This number cannot be specified
*				  
* # Verified Maximum Download - Similar to Verified Maximum Upload
*
*
* # Verified Upload Limit - The amount of upload bandwidth you are dedicating.  
* This can be specified, but it is recommended not to.
* Must be between Verified Max and 0,
* Verified Max >= Verified Upload Limit >= 0
*				  
* # Verified Download Limit - Similar to Verified Upload limit
*
*----------------------------------------------------------------------------------------------
*
*
************ To change your server's bandwidth mode go to Settings->Options->General
***********************************************************************************************



Listen
-----------------------------------------------------------------------------------------------
Enter a broadcaster address (http://s2s.sourceforge.net/stations).  

Buttons -
|join| - connect.
|bump| - changes to another peer supplier.
|leave| - disconnect, afterwards you can connect to another station.


Broadcast
-----------------------------------------------------------------------------------------------
There 2 different ways to broadcast:
1. Relay:  Enter an existing shoutcast (www.shoutcast.com) or icecast (www.icecast.org) 
   server address, press  |Serve Public|  or  |Serve Private|.

2. New s2s Station:  Create a private local shoutcast/icecast server, 
   load media onto the shoutcast server, enter the address in s2s 
   (e.g. http://127.0.0.1:8000), press  |Serve Public|  or  |Serve Private|.

Buttons -
|Serve Public| - Broadcasts the station and adds it to the s2s yellow pages
|Serve Private| - Broadcasts the station
|Add to yellow pages| - AT THE MOMENT THIS DOES NOT WORK CORRECTLY
|Remove from the yellow pages| - Removes the station from the yellow pages


History
-----------------------------------------------------------------------------------------------
# When you connect to a station it is added to your station history.

# To access stations you have connected to, press the arrow on the drop down box,
select a station, and press join.


Settings
-----------------------------------------------------------------------------------------------
# To configure s2s go to settings->options.  

# Various options can be set here.  

# Press |Save Settings| when you are done configuring to save settings out to xml.


Reasons for denial
-----------------------------------------------------------------------------------------------
Clients can be denied service for the following reasons: 

 1. Old version of software
 2. IP address does not match the tested IP address
 3. Verified Upload Bad 
 4. Verified Download Bad
 5. Not enough download
 6. Not enough upload


What is?
-----------------------------------------------------------------------------------------------

# Uptime - The amount of time the station has been running.  
  This is just the timestamp being displayed.

# Log - Log to a file with the date and time of day as the filename

# Log As - Log to a file by specifying a filename.  NOTE:  If this is set in the options
  menu the log will be overwritten every time the program is started.


FAQ
-------------------------------------------------------------------------------------
Q:  Can a stream be recorded to a file and viewed in the media player simultaneously?

A:  Yes, and they can also be done separate.


Q:  When trying to connect to a station I receive:
    "Server denies:  Your IP address is different from the one tested.  
     Re-test your bandwidth."

A:  Generally these messages are self explanatory, but this one is different.  
    Every time you test your bandwidth, your internet IP address is recorded.  
    This address is sent to the server when connecting.  
    The first three octets(x.x.x.y (y is not checked)) of this address are checked 
    against the first three octets of the ip the server sees.  

    If the first three octets of the two IPs are different, you will be denied service.  
    
    Accepted:  24.35.77.55 -- 24.35.77.55
    Accepted:  126.96.22.45 -- 126.96.22.222
    
    Denied:  25.66.77.88 -- 177.88.33.114
 
    You will need to re-test your bandwidth if you are denied for this reason.
    

Q:  s2s will not run for me anymore

A:  Move (cut or copy->paste->delete old) your ClientSettings.xml or 
    ServerSettings.xml file to another folder.  Re-launch s2s.  Report the bug and 
    what you did the last time it was working in the forums.  Open up the xml settings 
    in notepad and paste the text into your post.


Please post bugs, suggestions, and lag numbers in the forums!!!!!!!!!! 

http://s2s.sourceforge.net









S2S uses NDT for bandwidth testing, license:

Copyright (c) 2003 University of Chicago. All rights reserved.
The Web100 Network Diagnostic Tool (NDT) is distributed subject to the following license conditions:

SOFTWARE LICENSE AGREEMENT
Software: Web100 Network Diagnostic Tool (NDT)

1. The "Software", below, refers to the Web100 Network Diagnostic Tool (NDT) (in either source code, or binary form and accompanying documentation). Each licensee is addressed as "you" or "Licensee."

2. The copyright holder shown above hereby grants Licensee a royalty-free nonexclusive license, subject to the limitations stated herein and U.S. Government license rights.

3. You may modify and make a copy or copies of the Software for use within your organization, if you meet the following conditions:
    a. Copies in source code must include the copyright notice and this Software License Agreement.
    b. Copies in binary form must include the copyright notice and this Software License Agreement in the documentation and/or other materials provided with the copy.

4. You may make a copy, or modify a copy or copies of the Software or any portion of it, thus forming a work based on the Software, and distribute copies outside your organization, if you meet all of the following conditions:
    a. Copies in source code must include the copyright notice and this Software License Agreement;
    b. Copies in binary form must include the copyright notice and this Software License Agreement in the documentation and/or other materials provided with the copy;
    c. Modified copies and works based on the Software must carry prominent notices stating that you changed specified portions of the Software.

5. Portions of the Software resulted from work developed under a U.S. Government contract and are subject to the following license: the Government is granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable worldwide license in this computer software to reproduce, prepare derivative works, and perform publicly and display publicly.

6. WARRANTY DISCLAIMER. THE SOFTWARE IS SUPPLIED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE COPYRIGHT HOLDER, THE UNITED STATES, THE UNITED STATES DEPARTMENT OF ENERGY, AND THEIR EMPLOYEES: (1) DISCLAIM ANY WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE OR NON-INFRINGEMENT, (2) DO NOT ASSUME ANY LEGAL LIABILITY OR RESPONSIBILITY FOR THE ACCURACY, COMPLETENESS, OR USEFULNESS OF THE SOFTWARE, (3) DO NOT REPRESENT THAT USE OF THE SOFTWARE WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS, (4) DO NOT WARRANT THAT THE SOFTWARE WILL FUNCTION UNINTERRUPTED, THAT IT IS ERROR-FREE OR THAT ANY ERRORS WILL BE CORRECTED.

7. LIMITATION OF LIABILITY. IN NO EVENT WILL THE COPYRIGHT HOLDER, THE UNITED STATES, THE UNITED STATES DEPARTMENT OF ENERGY, OR THEIR EMPLOYEES: BE LIABLE FOR ANY INDIRECT, INCIDENTAL, CONSEQUENTIAL, SPECIAL OR PUNITIVE DAMAGES OF ANY KIND OR NATURE, INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS OR LOSS OF DATA, FOR ANY REASON WHATSOEVER, WHETHER SUCH LIABILITY IS ASSERTED ON THE BASIS OF CONTRACT, TORT (INCLUDING NEGLIGENCE OR STRICT LIABILITY), OR OTHERWISE, EVEN IF ANY OF SAID PARTIES HAS BEEN WARNED OF THE POSSIBILITY OF SUCH LOSS OR DAMAGES.

The Software was developed at least in part by the University of Chicago, as Operator of Argonne National Laboratory (http://miranda.ctd.anl.gov:7123/).