Stream.JoinWeb's Media Linking Instructions

How to send files to your Account Standard FTP (File Transfer Protocol) What to upload to your Account Linking your media to play on your Web site RealNetworks - Enabling RealMedia to Stream Real 7 & 8. Using RAMGEN (direct linking) Real 7 & 8. Using RAM Files (simple text files) Playing 5.0 or older RealMedia files WindowsMedia - Enabling WindowsMedia to Stream QuickTime -- Enabling QuickTime to Stream Streaming in the QuickTime Player Streaming in the Browser True Streaming vs. Progressive Download MP3s - Streaming MP3 Sample Files - List of All Samples Files with Links Support

1. HOW TO SEND YOUR MEDIA FILES TO YOUR ACCOUNT


To move your media files into your account, you will need your userID and password.


1. Standard (FTP):


The standard method of moving your media into your Media account is to use FTP software (FTP Client), which can usually be found as a free download on Web sites that provide access to utility software products. FTP stands for File Transfer Protocol. If you do not have FTP software installed on your computer, we recommend that you visit Download.com (http://www.download.com) to download one of the following free FTP programs:

We Recommend: www.Download.com

FTP for PCs: Cute FTP, WS FTP, or FTP Voyager FTP for Macs: Fetch

Your FTP program will require you to know:

UserID/Login: [[AccountLogin]]
Password: [[AccountPassword]]
FTP address: upstream.joinweb.com


Once you enter the above information in your FTP program, you will access your account.


2. WHAT TO UPLOAD TO YOUR ACCOUNT?


Once you have chosen the method to upload your media to your account, you are ready to begin.

Once you have logged in you are in the directory where you will upload all your media content, including RealMedia, WindowsMedia, and QuickTime content, RealAudio,RealVideo, RealText, RealPic, RealFlash,RealText-3D, MP3s and your SMIL (text files which end in ".smi"). Do NOT upload your Web HTML pages into this directory. This account does not serve HTML Web pages.


3. LINKING YOUR MEDIA TO PLAY ON YOUR WEB SITE


The section below illustrates how to enable RealMedia, QuickTime, WindowsMedia and MP3s to play on your Web site. You will need to have access to your Web site to do this, including the ability to add a "link" to a Web page.

If you have experience adding links and are ready to begin, then skip to the link identifiers you will use below. Otherwise, each section will describe how to play each type of media on your Web site.

RealMedia: real.joinweb.com (Plays Real 7 & Real 8)
Windows Media: win.joinweb.com
QuickTime: quick.joinweb.com





2. REALNETWORKS - ENABLING REALMEDIA TO STREAM


You may link to your RealMedia in one of three methods described below.


1. The "RAMGEN" Method (easiest):
   
   Let's say your RealMedia file is named: "audio.rm" Upload this file to your directory as described above. Then, create a "link" on your Web site that points to:
   
   Audio Sample:
   
   http://real.joinweb.com:8080/ramgen/[[AccountLogin]]/audio.rm
   
   Note: Be careful when typing as linking is upper/lower case sensitive. Go ahead and try the link above. It should play the sample file in your account.
   
   Note that there is a ":8080" number in this link. This is called a "port" number (preceeded by a colon) and you should insert it in your links. This number will not change. This number informs our servers that your request is coming in through a specific port on our system. The "ramgen" word must also be inserted, as shown above. This "code" informs your browser to launch the RealPlayer.
   
   
2. The "RAM" Method: (slightly more difficult)
   
   This was the method of linking to media on a Web site prior to the release of the "RAMGEN" method described above. It involves an additional step.
   
   Let's say your RealMedia file is named: "audio.rm". Upload this file to your directory.
   
   Next, you will need to create a simple text file* with the following text entered (in upper, left corner):
   
   *(Windows users can do this with Notepad or TextPad; MAC users with Simple Text.) Audio Sample:
   
   rtsp://real.joinweb.com:554/[[AccountLogin]]/audio.rm
   
   Save this text file by any name (no spaces) with the extension ".ram" after it (i.e: movie.ram). Note that the number "554" designates a specific port on our system that we recommend you use. This number will not change and should be in all your links.
   
   Upload this RAM file onto your Web site (not your Account). Create a link on your Web page to this file. For example:
   
   http://www.YOURWEBSITE.com/movie.ram
   
   ...would be embedded on your Web page. Now test your movie by launching your browser. Go to your Web site and click on the link that you have created in your Web page. That link should launch the "movie.ram" file, which is a simple instruction that tells RealPlayer to launch and play the file inside of that text file (try and copy this link in your RealPlayer):
   
   rtsp://real.joinweb.com:554/[[AccountLogin]]/audio.rm
   
   
3. Real 5.0 or older Files:
   
   If you are streaming media using Real 5.0 or older, you will not be able to use the above method. You must use the PNM protocol, instead, with port 7070 inserted in the link. An example of this method is:
   
   pnm://real.joinweb.com:7070/[[AccountLogin]]/audio.rm
   
   ----------RealNetworks Support-----------
   
   http://service.real.com/index.html
   http://www.realnetworks.com/devzone/library/index.html





3. WINDOWSMEDIA -- ENABLING WINDOWSMEDIA TO STREAM ON YOUR WEB SITE


We attach and .asp file with an example of how to display media embedded in a page (you will need ASP on your site to test this example, but you may save check the code to get ideas on how to adapt to .HTML)

To play WindowsMedia on your Web site, you will need to create a text file* (that ends in ".ASX") which you place on your Web site with the address (also known as the "URL") of your WindowsMedia file inside it. This process is almost identical to the RealMedia "RAM" method described above, except that the text file ends with the extension ".asx".

*Note: Windows users can create this file using Notepad or TextPad. Mac users can create it using Simple Text.

Let's say your WindowsMedia file is named: "sample.asf"

Upload this file to your media account. Next, create a simple text file with the following text entered (in upper, left corner):

Audio Sample:

<ASX Version="3.0">
<ENTRY>
<REF href = "mms://win.joinweb.com/[[AccountLogin]]/audio.wma" />
</ENTRY>
</ASX>

Save this text file by any name you want (no spaces) with the extension ".asx" after it (i.e: movie.asx).

Upload this "ASX" text file onto your Web site (not your account). Create a link on Your Web page to this file.

For example: http://www.YOURWEBSITE.com/movie.asx

Now test your movie by launching your browser, going to your Web site and clicking on the link that you have created in your Web page. That link should launch the "movie.asx" file, which is a simple instruction that tells WindowsMedia Player to launch (and shows the Player where to retrieve the media file):

Audio Sample:

mms://win.joinweb.com/[[AccountLogin]]/audio.wma

Note: The 7 encoder creates video files with a .wmv extension, this is same as a .asf extension.

Note: You may find that the ASX file isn't needed for Internet Explorer users. We ask that you do this because it is needed for Netscape Navigator users.

Note: You may link to your Windows Media file using HTTP (see samples below). However, if you do so, you will lose many benefits that improve the quality of your streaming, and Netscape browsers may not launch your player. Thus, we do not recommend you using the linking method below (though you may want to click to test them for educational purposes).

http://win.joinweb.com/[[AccountLogin]]/audio.wma

----------WindowsMedia Support----------

http://www.microsoft.com/windows/windowsmedia/en/default.asp
http://msdn.microsoft.com/windowsmedia/default.asp






4. QUICKTIME- ENABLING QUICKTIME TO STREAM ON YOUR WEB SITE



1. Streaming In The QuickTime Player


To link your QuickTime content you must first embed a static movie into your Web page. To create this static movie, first open the image of the link you want to use in the QuickTime Player. While still in the QuickTime Player, save it as a "self-contained movie." This image movie will reside on your Web server.

Next, use an embed tag in your HTML that looks like this:

<embed src="image movie on your web server"
type="video/quicktime"
height="image movie height"
width ="image movie width"
autoplay="true" controller="false"
href="rtsp://quick.joinweb.com/[[AccountLogin]]/audio.mov"
target="quicktimeplayer">


2. Streaming In The Browser


To stream your QuickTime content in the browser, you will first need to create a reference movie. To do this, download Apple's MakeRefMovie tool. It can be found at:

http://developer.apple.com/quicktime/quicktimeintro/tools/

After downloading and installing this application, launch the application, and select "ADD URL" under the "MOVIE" menu to create your Reference Movie File (static movie) that will reside on your Web site. In the "Add URL" window, you will add the link to your "Hinted Movie File" that you uploaded to your Account.

This link is VERY IMPORTANT. It should look like this:

rtsp://quick.joinweb.com/[[AccountLogin]]/audio.mov

Leave all of the default settings and save the reference movie you have created. Then place this reference movie on your web server. To display the streaming movie on your page use the following embed tag:

<embed src="reference movie on your web server"
type="video/quicktime"
height="streaming movie height"
width=" streaming movie width"
autoplay="true"
controller="false" >

Note: Apple provides for two streaming technologies:


3. Progressive Download & True Streaming


The difference between the two technologies is that "progressive download" is not a streaming media technology, but an actual download of the media file. QuickTime files using this method actually reside on the Web site, not on a streaming server.

For small, short clips, many users find the quality in progressive downloads to be quite impressive. For larger, longer files, this technology may prove insufficient. Viewers may not have or desire to have these large files on their computer. We only support Apple's True Streaming Technology, designed for QuickTime 4.0 & 5.0 files, on our servers.

----------Apple's QuickTime Support----------

www.apple.com/quicktime/authoring/
www.apple.com/quicktime





5. MP3s


Did you know that a single MP3 file can play in both, Real and WindowsMedia players? They can also play in QuickTime players if you hint the file with a ".mov" extension. Try these examples:

For Real Player: http://real.joinweb.com:8080/ramgen/[[AccountLogin]]/audio.mp3

For WindowsMedia Player: mms://win.joinweb.com/[[AccountLogin]]/audio.mp3




6. SAMPLES


Your Account includes sample audio and video files which will help you evaluate our service. These samples are:


1. Real Networks Media Sample


Audio Sample:

http://real.joinweb.com:8080/ramgen/[[AccountLogin]]/audio.rm
2. Microsoft's Windows Media Sample


Audio Sample:

mms://win.joinweb.com/[[AccountLogin]]/audio.wma
3. Apple's QuickTime Media Sample


Type the following in the open URL field of your QuickTime player. Audio Sample:

rtsp://quick.joinweb.com/[[AccountLogin]]/audio.mov
4. MP3 Streaming Audio


(You can link to same file with Real or Windows Media) Real Version:

http://real.joinweb.com:8080/ramgen/[[AccountLogin]]/audio.mp3

Type the following into the open URL field of your WindowsMedia player. Windows Version: mms://win.joinweb.com/[[AccountLogin]]/audio.mp3





7. SUPPORT


For tips and additional insights, please see our support section at at our web site.

----------Other Resources----------

http://www.StreamingMedia.com
http://www.streamingmediaworld.com

Meanwhile, should you have any questions, please don't hesitate to contact us. We are constantly improving our service and we have many exciting new announcements forthcoming. We look forward to your business. A copy of these instructions may also be found in your account.