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