---------------------------------------------------- MICROSOFT NETSHOW PLAYER 2.0 BETA 1 FOR UNIX (c) 1998 Microsoft Corporation, all rights reserved ---------------------------------------------------- ======== CONTENTS ======== a. Installation b. Known Bugs c. License Agreement -------------------------------------------- A ) --** Installation **-- -------------------------------------------- I) After downloading the Netshow archive the following steps should be taken to install Netshow onto your system. 1) Untar the archive. This will create a directory called netshow and with some files inside it. "tar -xvf NetShow_Solaris_Beta.tar" 2) Go into the newly created netshow directory. "cd netshow" 3) Add execution priviledges to the netshow binary. "chmod +x netshow" 4) Move the netshow binary to where ever you keep your executables. One common place is "/usr/local/bin". In this case you would type: "cp netshow /usr/local/bin" 5) Next we'll create a directory to keep the Netshow HTML help page in. You may need to be superuser in order to create this directory on your system. "mkdir /usr/local/netshow" Move the Netshow Help file into the directory "cp help.html /usr/local/netshow" If you wish to place the "help.html" file in a directory other than listed above, then you need to create an env variable NETSHOW_HOME_DIR and set it equal to that directory. For example, if you place "help.html" in the directory "/global/netshow" then you need to: "setenv NETSHOW_HOME_DIR /global/netshow" so that netshow knows where to find the help file. 6) In order to play ASF files that use the Voxware audio codecs you need to create the following directory to store the Voxware plugins. Again, you may need to be superuser in order to do this depending on how your system is setup. "mkdir /usr/local/voxware" "mkdir /usr/local/voxware/plugins" Now copy the Voxware plugins into that directory. "cp *.vwp /usr/local/voxware/plugins" If you wish to place the *.vwp files in a directory other than listed above, then you need to create an env variable VOXWARE_PLUGIN_DIR and set it equal to that directory. For example, if you place the *.vwp files in the directory "/global/voxware/plugins" then you need to: "setenv VOXWARE_PLUGIN_DIR /global/voxware/plugins" so that netshow knows where to find those files. II) --** Setting NetShow up as a Helper Application for a WWW Browser **-- A -- NETSCAPE USERS There are three things you need to do in order to get your WWW browser to properly call up NetShow to view ASF files. 1) Setting up your ".mime.types" file. This file will classify a file name to a particular MIME type and subtype based on the extension of that file name. Edit the ".mime.types" file in your home directory and add the following line at the top: video/x-ms-asf asf asx For example if this is what your ".mime.types" file looks like now: video/mpeg mpg mpeg video/quicktime qt mov video/avi avi video/fli fli flc audio/wav wav audio/au au You would change it to be (by adding the top line): video/x-ms-asf asf asx video/mpeg mpg mpeg video/quicktime qt mov video/avi avi video/fli fli flc audio/wav wav audio/au au 2) Setting up your ".mailcap" file. This file maps MIME types/subtypes to applications that can display or handle them. WWW browsers use this file to determine what program(also known as an Helper Application) should be called to for a file it has just downloaded. Edit the ".mailcap" file located in your home directory and add the following line at the top of it: video/x-ms-asf; netshow %s; You may want to give the full path name to where you place the "netshow" executable. For example if you placed "netshow" in the directory "/usr/local/bin", you would add the following line to the ".mailcap" instead of the one above: video/x-ms-asf; /usr/local/bin/netshow %s; For example if you put "netshow" in "/usr/local/bin" and this is what your ".mailcap" file looks like now: video/mpeg; mpeg_play %s ; video/*; xanim %s; audio/wav; xanim %s; audio/au; xanim %s; audio/x-mpeg; maplay %s; audio/x-pn-realaudio; raplayer %s; image/*; xv %s; You would change it to be(by adding the top line): video/x-ms-asf; /usr/local/bin/netshow %s; video/mpeg; mpeg_play %s; video/*; xanim %s; audio/wav; xanim %s; audio/au; xanim %s; audio/x-mpeg; maplay %s; audio/x-pn-realaudio; raplayer %s; image/*; xv %s; B -- INTERNET EXPLORER USERS 1. From iexplorer's View menu, select "Internet Options." 2. Select the rightmost tab, "mapping" 3. Hit the "New Association" button 4. under description, enter something useful, like "Microsoft NetShow Content." 5. under extension(s), enter .asf;.asx; 6. for mime type, enter video/x-ms-asf 7. for command line, enter the full path to the NetShow executable you set up in previous steps, followed by "%1." For example, if the path to NetShow is /usr/local/bin/netshow, enter /usr/local/bin/netshow %1 8. Hit "Apply Association," then "Ok." That should do it.... C -- USERS OF OTHER BROWSERS Most WWW Browser's for unix know about the ".mime.types" and ".mailcap" files (see section A, "Netscape Users")located in your home directory and automatically look for them. There is also usually an "Options" menu that allows you to specify the location of these files. Consult the instructions, man pages, or help features that came with the particular WWW browser that you wish to configure. -------------------------------------------- B ) --** Known Bugs **-- -------------------------------------------- Playback -------- Playback of live streams is broken in this build. You can not fast forward or rewind if the stream is coming from a NetShow 3.0 Server via HTTP. This is due to version compatibility issues. When streaming via HTTP from a NetShow 3.0 Server, the markers do not respond. By design, markers do not work when receiving a HTTP stream from a HTTP server. Audio encoded with Voxware AC96 plays back at the incorrect speed. The audio and video lose synchronization. The audio falls behind the video several seconds. If Microsoft Internet Explorer is running in another session on another screen, and IE is set as the player's default browser, the URL flips passed from the NetShow Player will not occur, nor will the help command work. Users streaming via HTTP from a NetShow server (not an IIS server) may experience their file repeating forever, despite playback being set to play the file a single time. Authentication -------------- This version of the player does not authenticate a challenge from a NetShow 3.0 server using HTTP basic authentication with membership. Settings -------- Numerical settings made in the advanced tab (such as port number for UDP and proxy) may not persist if you use the mouse to hit the "Apply" or "OK" buttons. If you hit on the keyboard and then "OK," the settings should persist. -------------------------------------------- C ) --** License Agreement **-- -------------------------------------------- Microsoft Media Player for Unix END-USER LICENSE AGREEMENT FOR MICROSOFT SOFTWARE IMPORTANT-READ CAREFULLY: This Microsoft End-User License Agreement ("EULA") is a legal agreement between you (either an individual or a single entity) and Microsoft Corporation for the Microsoft software product(s) identified above which may include associated media, printed materials, and "online" or electronic documentation ("SOFTWARE PRODUCT"). By installing, copying, or otherwise using the SOFTWARE PRODUCT, you agree to be bound by the terms of this EULA. If you do not agree to the terms of this EULA, do not install, copy or otherwise use the SOFTWARE PRODUCT. The SOFTWARE PRODUCT is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. The SOFTWARE PRODUCT is licensed, not sold. 1. GRANT OF LICENSE. The SOFTWARE PRODUCT is licensed as follows: *Installation and Use. You may install and use an unlimited number of copies of the SOFTWARE PRODUCT on computers at your premises. Each computer may be connected at any point in time to an unlimited number of workstations or computers operating on one or more internal and/or external networks. * Backup Copies. You may also make copies of the SOFTWARE PRODUCT as may be necessary for backup and archival purposes. 2. DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS. * Prerelease Software. If any component of the SOFTWARE PRODUCT or any of its components is marked "Prerelease" or "Beta", the component of the SOFTWARE PRODUCT constitutes pre-release code and may be changed substantially before commercial release. You may not use such component in a live operating environment where it may be relied upon to perform in the same manner as a commercially released product or with data that has not been sufficiently backed up. * Maintenance of Copyright Notices. You must not remove or alter any copyright notices on all copies of the SOFTWARE PRODUCT. * Distribution. You may not distribute copies of the SOFTWARE PRODUCT to third parties, except as expressly provided in Section 1. * Prohibition on Reverse Engineering, Decompilation, and Disassembly. You may not reverse engineer, decompile, or disassemble the SOFTWARE PRODUCT, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation. * Rental. You may not rent, lease, or lend the SOFTWARE PRODUCT. * Transfer. You may permanently transfer all of your rights under this EULA, provided the recipient agrees to the terms of this EULA. * Support Services. Microsoft may, but it not obligated to, provide you with support services related to the SOFTWARE PRODUCT ("Support Services"). Use of Support Services is governed by the Microsoft polices and programs described in the user manual, in "on line" documentation and/or other Microsoft-provided materials. Any supplemental software code provided to you as part of the Support Services shall be considered part of the SOFTWARE PRODUCT and subject to the terms and conditions of this EULA. With respect to technical information you provide to Microsoft as part of the Support Services, Microsoft may use such information for its business purposes, including for product support and development. Microsoft will not utilize such technical information in a form that personally identifies you. * Compliance with Applicable Laws. You must comply with all applicable laws regarding use of the SOFTWARE PRODUCT. 3. TERMINATION. Without prejudice to any other rights, Microsoft may terminate this EULA if you fail to comply with the terms and conditions of this EULA. In such event, you must destroy all copies of the SOFTWARE PRODUCT. 4. COPYRIGHT. All title, including but not limited to copyrights, in and to the SOFTWARE PRODUCT and any copies thereof are owned by Microsoft or its suppliers. All title and intellectual property rights in and to the content which may be accessed through use of the SOFTWARE PRODUCT is the property of the respective content owner and may be protected by applicable copyright or other intellectual property laws and treaties. This EULA grants you no rights to use such content. All rights not expressly granted are reserved by Microsoft. 5. U.S. GOVERNMENT RESTRICTED RIGHTS. All SOFTWARE PRODUCT provided to the U.S. Government pursuant to solicitations issued on or after December 1, 1995 is provided with the commercial rights and restrictions described elsewhere herein. All SOFTWARE PRODUCT provided to the U.S. Government pursuant to solicitations issued prior to December 1, 1995 is provided with RESTRICTED RIGHTS as provided for in FAR, 48 CFR 52.227-14 (JUNE 1987) or FAR, 48 CFR 252.227-7013 (OCT 1988), as applicable. 6. EXPORT RESTRICTIONS. You agree that you will not export or re-export the SOFTWARE PRODUCT to any country, person, entity or end user subject to U.S. export restrictions. You specifically agree not to export or re-export the SOFTWARE PRODUCT (i) to any country to which the U.S. has embargoed or restricted the export of goods or services, which currently include, but are not necessarily limited to Cuba, Iran, Iraq, Libya, North Korea, Sudan and Syria, or to any national of any such country, wherever located, who intends to transmit or transport the products back to such country; (ii) to any end-user who you know or have reason to know will utilize the SOFTWARE PRODUCT in the design, development or production of nuclear, chemical or biological weapons; or (iii) to any end-user who you know or have reason to know has been prohibited from participating in U.S. export transactions by any federal agency of the U.S. government. 7. NO WARRANTIES. Microsoft expressly disclaims any warranty for the SOFTWARE PRODUCT and SUPPORT SERVICES (if any). THE SOFTWARE PRODUCT AND ANY RELATED DOCUMENTATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OR MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. THE ENTIRE RISK ARISING OUT OF USE OR PERFORMANCE OF THE SOFTWARE PRODUCT REMAINS WITH YOU. 8. LIMITATION OF LIABILITY. To the maximum extent permitted by applicable law, in no event shall Microsoft or its suppliers be liable for any special, incidental, indirect, or consequential damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use the SOFTWARE PRODUCT or the provision of or failure to provide Support Services, even if Microsoft has been advised of the possibility of such damages. In any case, Microsoft's entire liability under any provision of this EULA shall be limited to the greater of the amount actually paid by you for the SOFTWARE PRODUCT or US$5.00; provided however, if you have entered into a Microsoft Support Services Agreement, Microsoft's entire liability regarding Support Services shall be governed by the terms of that agreement. Because some states and jurisdictions do not allow the exclusion or limitation of liability, the above limitation may not apply to you. 9. MISCELLANEOUS. This EULA is governed by the laws of the State of Washington, U.S.A. Should you have any questions concerning this EULA, or if you desire to contact Microsoft for any reason, please contact the Microsoft subsidiary serving your country, or write: Microsoft Sales Information Center/One Microsoft Way/Redmond, WA 98052-6399. Si vous avez acquis votre produit Microsoft au CANADA, la garantie limitée suivante vous concerne: EXCLUSION DE GARANTIES. Microsoft exclut expressément toute garantie relative au LOGICIEL. Le LOGICIEL et la documentation y afférente sont fournis "en l'état", sans garantie d'aucune sorte, expresse ou implicite, y compris, de manière limitative, sans aucune garantie de qualité, d'adéquation à un usage particulier ou de non-contrefaçon. Vous assumez l'ensemble des risques découlant de l'utilisation ou des performances du LOGICIEL. Pas de Responsabilité pour les Dommages Indirects - Microsoft ou ses fournisseurs ne seront pas responsables en aucune circonstance pour tout dommage spécial, incident, indirect, ou conséquent quel qu'il soit (y compris, sans limitation, les dommages entrainés par la perte de bénéfices, l'interruption des activités, la perte d'information ou toute autre perte pécuniaire) découlant de l'utilisation ou de l'impossibilité d'utilisation de ce LOGICIEL ainsi que pour toute disposition concernant le Suport Technique ou la façon dont celui-ci a été rendu et ce, même si Microsoft a été avisée de la possibilité de tels dommages. la responsabilité de Microsoft en vertu de toute disposition de cette convention ne pourra en aucun temps excéder le plus élevé entre i) le montant effectivement payé par vous pour le LOGICIEL ou ii) US$5.00. advenant que vous ayez contracté par entente distincte avec Microsoft pour un Support Technique étendu, vous serez lié par les termes d' une telle entente. La présente Convention est régie par les lois de la province d'Ontario, Canada. Chacune des parties à la présente reconnaît irrévocablement la compétence des tribunaux de la province d'Ontario et consent à instituer tout litige qui pourrait découler de la présente auprès des tribunaux situés dans le district judiciaire de York, province d'Ontario. Au cas où vous auriez des questions concernant cette licence ou que vous désiriez vous mettre en rapport avec Microsoft pour quelque raison que ce soit, veuillez contacter la succursale Microsoft desservant votre pays, dont l'adresse est fournie dans ce produit, ou écrivez à : Microsoft Sales Information Center, One Microsoft Way, Redmond, Washington 98052-6399.