Oggplayer Readme File Version 1.0 Jan 15 2004 ====================================================================== Installation : -------------------------------------------------------------------- The oggsetup executable should install the program under "/programs" It will extract an art.dat which is needed to run the application. Oggplayer will not work without an art.dat. Requirements : -------------------------------------------------------------------- Whomp requires Pocket Pc 2002 or Pocket Pc 2003 to run. How To Use -------------------------------------------------------------------- Ogg Player will play Ogg/Vorbis format audio files on your pocket pc. Encoders for Ogg/Vorbis are easily found on the web. There is also a Nero plug-in for free online to generate these files. Ogg/Vorbis is superior to mp3 in quality/size compression. Ogg is a processing heavy decompressor, and pocket pc devices vary greatly in processing power. When you first use the ogg player, you will notice a "device speed" menu option. Start by setting this to "Low" and play a file, if it does not jump or skip, change to medium, test again, ect... The program will respond to commands such as stop, or change song faster when running on a high speed device setting. Therefore, you should run the software with the fastest setting that your device can handle without skipping during playback. When installed, the software will associate Ogg files also, so that you can simply tap on them from a file browser and they will load into the ogg player for playback. Ogg Player also has the concept of play lists. These are lists of several ogg/vorbis files to be played one after the other. You can build this list by loading ogg files into the player using the "playlist->add ogg" menu option, or tapping the "+" sign on the interface. Once you have built a play list, you can save it for later use, and shuffle the contents around for randomized playback. If you save a play list, and then move the ogg files in that list to a new location, when you load that play list again, it will prompt you to find these files. This is useful for moving play lists between your pocket pc and your desktop computer. Mearly move the ogg files and the playlist file (*.OPL), load the playlist, which will prompt you to find the first file in the list, and then the list will find the other ogg files in that same location. Then save over the playlist. As the player attempts to load the ogg files, it will continue to prompt you for each that it cannot find. You can also concatinate or "tack on" a playlist to another playlist (*.OPL), by using the "append play list" menu option, or the right most interfact button. This is convenient for setting up a large number of songs to play. Interface Buttons: -------------------------------------------------------------------- There are 2 rows of buttons on the standard skin interface. Here are the functions of these buttons. Top Row, Left to Right: 1. Up Arrow. This moves a selected song in the playlist up in the order 1 slot. 2. Down Arrow. This moves a selected song in the playlist down in the order 1 slot. 3. X. This will delete any/all selected songs in the playlist. 4. Plus Sign. This will open a dialog to add an ogg file to the playlist. 5. Right Turn. This will "append" a playlist to the current playlist. 2nd Row, Left to Right: 6. Check. This will open a dialog to save the playlist. 7. Not sign, the circle with a slash. This will clear the play list. Links: -------------------------------------------------------------------- This link is to download the free Ogg Encoder for Windows or Linux. http://winvorbis.stationplaylist.com/ This link is to download the free Ogg encoder plugin for Nero Burning Rom This will allow you to rip straight into Ogg format. http://neroplugins.cd-rw.org/ Trouble Shooting: -------------------------------------------------------------------- "Audio Pops" - This is because your machine speed is set too high, set it to medium or low, and this should go away. Some devices, such as the iPaq 3600 series have this issue regardless, and it is a driver bug. "The player comes up all black." - Insure that the file Art.dat is in the folder with the OggPlayer executable. By default this is in "\program files\Ogg Player". If Art.dat is NOT there, or it is and the player is still not working, uninstall it and reinstall it. This will reset the registry entries, and should fix the issue. Rebooting your pocket pc helps reset the memory and reduced memory fragmentation. Machine Speed: -------------------------------------------------------------------- From some testing, we've found that most Pocket PC's operate well at the medium setting. The 400 mhz X-Scale based Toshiba E750, for instance, can run on high, unless you are using the pda to do other things while listening to ogg files, then the medium setting eliminates any audio issues. Credits: -------------------------------------------------------------------- Design, programming: Keith Leonard Art : Dave "Dub" Wells Installation: Robert Seres Misc. Legal: -------------------------------------------------------------------- This program uses OGG libraries which are copyrighted be the Xiph.Org Foundation (C) COPYRIGHT 1994-2002 More information about OGG can be found at www.vorbis.com The OGG binaries are distributed under the following agreement: Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the Xiph.org Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. This software is provided by the copyright holders and contributors “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the foundation or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage. Other OGG is distributed under the GNU License. Information on GNU can be found at www.gnu.org/copyleft/gpl.html This program uses Info-ZIP Copyright (c) 1990-2002 Info-ZIP. All rights reserved. // // For the purposes of this copyright and license, "Info-ZIP" is defined as // the following set of individuals: // // Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois, // Jean-loup Gailly, Hunter Goatley, Ian Gorman, Chris Herborth, Dirk Haase, // Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz, // David Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko, // Steve P. Miller, Sergio Monesi, Keith Owens, George Petrov, Greg Roelofs, // Kai Uwe Rommel, Steve Salisbury, Dave Smith, Christian Spieler, // Antoine Verheijen, Paul von Behren, Rich Wales, Mike White