1SMPlayer _VERSION_ _BUILD_ README 2 3(W) Christian Hennecke, Oct 5, 2009 4last update May 14, 2012 5 6 70. CONTENTS OF THIS FILE 8======================== 9 101. INTRODUCTION 11 122. REQUIREMENTS 13 143. INSTALLATION 15 164. LICENSE, COPYRIGHT, DISCLAIMER 17 185. CONTACT 19 206. CREDITS 21 227. SUPPORT AND DONATIONS 23 248. HISTORY 25 26 271. INTRODUCTION 28=============== 29 30Welcome to SMPlayer _VERSION_ _BUILD_ for OS/2 and eComStation. 31 32SMPlayer is a GUI front-end for MPlayer, a command-line movie player that is 33available for many systems and supports a wide range of formats and codecs, 34either natively or via Win32 DLL codecs. For instance, you can watch VideoCD, 35SVCD, DVD, 3ivx, DivX 3/4/5, WMV, and even H.264 movies. 36 37SMPlayer intends to be a complete front-end for MPlayer, from basic features 38like playing videos, DVDs, and VCDs to more advanced features like support for 39MPlayer filters and more. 40 41One of the most interesting features of SMPlayer: it remembers the settings of 42all files you play. So you start to watch a movie but you have to leave... 43don't worry, when you open that movie again it will resume at the same point 44you left it, and with the same settings: audio track, subtitles, volume... 45 46Other additional interesting features: 47 48 * Configurable subtitles. You can choose font and size, and even colors for 49 the subtitles. 50 * Audio track switching. You can choose the audio track you want to listen. 51 Works with avi and mkv. And of course with DVDs. 52 * Seeking by mouse wheel. You can use your mouse wheel to go forward or 53 backward in the video. 54 * Video equalizer, allows you to adjust the brightness, contrast, hue, 55 saturation and gamma of the video image. 56 * Multiple speed playback. You can play at 2X, 4X... and even in slow motion. 57 * Filters. Several filters are available: deinterlace, postprocessing, 58 denoise... and even a karaoke filter (voice removal). 59 * Audio and subtitles delay adjustment. Allows you to sync audio and 60 subtitles. 61 * Advanced options, such as selecting a demuxer or video & audio codecs. 62 * Playlist. Allows you to enqueue several files to be played one after each 63 other. Autorepeat and shuffle supported too. 64 * Preferences dialog. You can easily configure every option of SMPlayer by 65 using a nice preferences dialog. 66 * Possibility to search automatically for subtitles in opensubtitles.org. 67 * Translations: currently SMPlayer is translated into more than 20 languages, 68 including Spanish, German, French, Italian, Russian, Chinese, Japanese.... 69 * It's multiplatform. Binaries available for Windows, Linux, and now OS/2. 70 * SMPlayer is under the GPL license. 71 72 732. REQUIREMENTS 74=============== 75 76The following requirements need to be installed. 77 78 792.1 kLIBC, GCC4Core, Qt4 80------------------------ 81 82The installation of these products can be done either by RPM or ZIP files. 83 842.1.a RPM installation 85---------------------- 86 87kLIBC 88----- 89 90 1. yum install libc 91 92GCC4Core 93-------- 94 95 1. yum install libgcc 96 2. yum install gcc-stack-protector 97 3. yum install gcc-stdc++-shared-library 98 4. yum install gcc-supc++-shared-library 99 100Qt4 dll 101------- 102 103 1. yum install libqt4 104 2. Install the xsystray plugin as noted in the readme.os2 and also in 105 readme.xsystray 106 107 1082.1.b ZIP Installation 109---------------------- 110 111kLIBC 112----- 113 114 1. Download kLIBC 0.6.5 or better (see http://svn.netlabs.org/libc for more 115 information) 116 2. Install the files to your libpath eg x:\ecs\dll 117 118GCC4Core 119-------- 120 121 1. Download GCC4Core 1.2.1 or better from http://ftp.netlabs.org/pub/gcc 122 2. Install the files to your libpath eg. x:\ecs\dll 123 124Qt4 dll 125------- 126 127 1. Download Qt4 4.7.3 or better (see http://svn.netlabs.org/qt4 for more 128 information) 129 2. Install the files according to the readme 130 3. Install the xsystray plugin as noted in the readme.os2 and also in 131 readme.xsystray 132 133 1342.2 MPlayer, Win32 codecs 135------------------------- 136 137The installation of these products is only available as ZIP files. 138 139MPlayer 140------- 141 142 http://hobbes.nmsu.edu/h-search.php?key=mplayer&pushbutton=Search 143 144 WARNING: To use the combination of SMPlayer and MPlayer to its full extent, 145 at least version mplayer-dev-SVN-r27724-OS2-4.3.2.zip is required. 146 Earlier versions do not support scaling, i.e., you will always 147 see a video in its original size, regardless of the zoom setting 148 or fullscreen mode. 149 150Win32 codecs (optional) 151----------------------- 152 153 http://www.mplayerhq.hu/design7/dload.html#binary_codecs 154 155 MPlayer is able to use Win32 codec DLLs for codecs it does not support 156 natively. 157 158 1593. INSTALLATION 160=============== 161 162To install SMPlayer, do the following: 163 164MPlayer 165------- 166 167 1. Download a recent version of MPlayer. 168 2. Create a new directory for MPlayer. 169 3. Extract the MPlayer package to the new directory. 170 4. Copy the .mplayer subdirectory -- if included -- to your HOME directory. 171 5. To be able to use subtitles, copy a TrueType font of your choice to the 172 %HOME%\.mplayer directory and rename it to subfont.ttf. 173 174Win32 codecs 175------------ 176 177 1. Download the codec package from the MPlayer site. 178 2. Go to the directory where you installed MPlayer and create a "codecs" 179 subdirectory. 180 3. Extract the package to the "codecs" subdirectory. 181 4. Add a SET MPLAYER_CODECS_DIR statement to your CONFIG.SYS, and point it 182 to the "codecs" subdirectory you create above. 183 184SMPlayer 185-------- 186 187 1. Create a directory for SMPlayer. This will be called x:\smplayer below. 188 2. Extract the SMPlayer package to the new directory. 189 3. Create a WPS object for smplayer.exe 190 4. Start SMPlayer by double-clicking on the WPS object. 191 5. Open the settings dialog via "Options > Settings." 192 6. In the left pane, choose "General." 193 7. On the "General" tab in the "Paths" group, press the "Browse" button and 194 locate the MPlayer executable mplayer.exe. 195 8. In the "Output Device Driver" group, choose "kva" for "Video" and "dart" 196 for "Audio." 197 9. In the left pane, choose "Drives." 198 10. Under "Drives," select your CD-ROM and DVD drives. 199 11. In the left pane, go to "Subtitles." 200 12. On the "Font" tab in the "Font" group, you can either directly choose a 201 font file to use or select one of the fonts installed in your system: 202 * To select a specific font file, select the "TTF Font" radio button, press 203 "Browse," and locate the font file of the TrueType font you would like to 204 use for subtitles. 205 * To select an installed font, select the "System Font" radio button, press 206 "Choose," and select a TrueType font you would like to use for subtitles. 207 CAUTION: mplayer.exe will crash if you select a non-TrueType font! 208 13. To get prettier fonts, go to the "SSA/ASS Library" tab and enable the 209 option "Use SSA/ASS library for subtitle rendering." Optionally adjust the 210 color and font attributes. 211 14. Press OK to exit the settings dialog. 212 213If you have a slow machine, also do the following: 214 215 1. In the left pane, choose "Performance." 216 2. In the "Cache" group, enable the "Use cache" option. 217 3. Enable the "Skip frames" option. 218 219If you have a sound card that does not support 48kHz sampling rate, also do the 220following: 221 222 1. In the left pane, choose "Advanced." 223 2. In the "Audio Filter" entry field, enter: 224 225 resample=44100:0:1 226 227 2284. LICENSE, COPYRIGHT, DISCLAIMER 229================================= 230 231SMPlayer is copyright (C) 200-2013 Ricardo Villalba <ricardo@smplayer.info>. 232 233The OS/2 port is copyright (c) 2008, 2012 Silvan Scherrer. 234 235This program is free software; you can redistribute it and/or modify 236it under the terms of the GNU General Public License as contained in 237the file COPYING in the installation directory. 238 239The original source code is available at: 240 241 https://smplayer.info 242 243This program is distributed in the hope that it will be useful, 244but WITHOUT ANY WARRANTY; without even the implied warranty of 245MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 246 247For details, refer to the file COPYING. 248 249 2505. CONTACT 251========== 252 253If you find a bug, then add a ticket to the trac at 254http://svn.netlabs.org/qtapps 255 256Only bug reports with a reproducable bug are accepted. :-) 257 258 2596. CREDITS 260========== 261 262The port was done by: 263 264Silvan Scherrer aka _diver 265 266Thanks go to: 267 268 * Yuri Dario 269 * Doodle 270 * KO Myung-Hun 271 * Herwig Bauernfeind 272 * Christian Hennecke 273 274They either helped me when I had some nasty questions or did some testing for 275me. 276 277 2787. SUPPORT AND DONATIONS 279======================== 280 281SMPlayer is based on volunteer work. If you would like to support further 282development, you can do so in one of the following ways: 283 284 * Donate to the Qt4 project: see http://qt.netlabs.org for more information 285 286 * Contribute to the project: Besides actual development, this also includes 287 maintaining the documentation and the project web site as well as help 288 for users. 289 290 2918. HISTORY 292========== 293 2942012-05-14 295 * updated to SMPlayer version 0.8.0 296 2972012-03-16 298 * updated to SMPlayer version 0.7.1 299 3002011-12-27 301 * updated to latest SMPlayer svn code 302 3032011-11-11 304 * updated to Qt 4.7.3 305 * fixed a possible hang when ending SMPlayer while playing a movie (patch by Rudi) 306 3072010-06-30 308 * fixed a nasty 1 second delay 309 3102010-04-29 311 * updated to Qt4 4.6.2 312 * added support for mplayer -ao kai (latest mplayer version) 313 3142010-01-29 315 * updated to latest Qt4 source 316 * enabled colorkey (thanks to KO Myung-Hun) 317 3182009-11-11 319 * fixed hang with broken media 320 * changed to Qt4 beta4 321 3222009-10-22 323 * removed requirement for MPlayer DLLs to be in PATH or SMPlayer directory 324 (fixed in Qt) 325 * removed requirement for C:\PSFONTS\helv.pfb (fixed in Qt) 326 * added Screensaver functionality for Doodle Screensaver 327 3282009-10-02 329 * beta1 of newest SMPlayer version with Qt4 support 330 3312009-01-22 332 * fixed a crash when playing audio files 333 3342008-11-24 335 * added french and german readme (done by Guillaume Gay and Christian Hennecke) 336 * added nice looking icons for exe and folder (done by David Graser) 337 * updated Qt DLL with newest version from SVN 338 3392008-11-04 340 * fixed a bug in Qt DLL which occured when playing from playlist 341 * renamed icon files to match wps behaviour 342 3432008-10-27 344 * with newest mplayer from hobbes the resizing problem is fixed 345 * fixed a bug introduced when adding more file extensions 346 3472008-10-20 348 * switched to custom-built Qt DLL sqt.dll (latest version from svn.netlabs.org/qt) 349 * added a couple more file extensions to the open file dialog 350 3512008-10-14 352 * initial release 353