source: smplayer/trunk/os2/readme.os2

Last change on this file was 189, checked in by Silvan Scherrer, 8 years ago

SMPlayer: adjust version info in readme and some small glitches

File size: 11.3 KB
Line 
1SMPlayer _VERSION_ _BUILD_ README
2
3(W) Christian Hennecke, Oct 5, 2009
4last update August 31, 2016
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 libgcc4*
96 2. yum install libssp
97 3. yum install libstdc++ libstdc++6
98 4. yum install libsupc++ libsupc++6
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
107Zlib
108----
109
110 1. yum install zlib
111
112
1132.1.b ZIP Installation
114----------------------
115
116kLIBC
117-----
118
119 1. Download kLIBC 0.6.5 or better (see http://svn.netlabs.org/libc for more
120 information)
121 2. Install the files to your libpath eg x:\ecs\dll
122
123GCC4Core
124--------
125
126 1. Download GCC4Core 1.2.2 or better from http://ftp.netlabs.org/pub/gcc
127 2. Install the files to your libpath eg. x:\ecs\dll
128
129Qt4 dll
130-------
131
132 1. Download Qt4 4.7.3 or better (see http://svn.netlabs.org/qt4 for more
133 information)
134 2. Install the files according to the readme
135 3. Install the xsystray plugin as noted in the readme.os2 and also in
136 readme.xsystray
137
138Zlib
139----
140
141 1. Download zlib from http://rpm.netlabs.org/release/00/zip
142 2. Unpack and install z.dll to your libpath eg. x:\ecs\dll
143
144
1452.2 MPlayer, Win32 codecs
146-------------------------
147
148The installation of these products is only available as ZIP files.
149
150MPlayer
151-------
152
153 http://hobbes.nmsu.edu/h-search.php?key=mplayer&pushbutton=Search
154
155 WARNING: To use the combination of SMPlayer and MPlayer to its full extent,
156 at least version mplayer-dev-SVN-r27724-OS2-4.3.2.zip is required.
157 Earlier versions do not support scaling, i.e., you will always
158 see a video in its original size, regardless of the zoom setting
159 or fullscreen mode.
160
161Win32 codecs (optional)
162-----------------------
163
164 http://www.mplayerhq.hu/design7/dload.html#binary_codecs
165
166 MPlayer is able to use Win32 codec DLLs for codecs it does not support
167 natively.
168
169
1703. INSTALLATION
171===============
172
173To install SMPlayer, do the following:
174
175MPlayer
176-------
177
178 1. Download a recent version of MPlayer.
179 2. Create a new directory for MPlayer.
180 3. Extract the MPlayer package to the new directory.
181 4. Copy the .mplayer subdirectory -- if included -- to your HOME directory.
182 5. To be able to use subtitles, copy a TrueType font of your choice to the
183 %HOME%\.mplayer directory and rename it to subfont.ttf.
184
185Win32 codecs
186------------
187
188 1. Download the codec package from the MPlayer site.
189 2. Go to the directory where you installed MPlayer and create a "codecs"
190 subdirectory.
191 3. Extract the package to the "codecs" subdirectory.
192 4. Add a SET MPLAYER_CODECS_DIR statement to your CONFIG.SYS, and point it
193 to the "codecs" subdirectory you create above.
194
195SMPlayer
196--------
197
198 1. Create a directory for SMPlayer. This will be called x:\smplayer below.
199 2. Extract the SMPlayer package to the new directory.
200 3. Create a WPS object for smplayer.exe
201 4. Start SMPlayer by double-clicking on the WPS object.
202 5. Open the settings dialog via "Options > Settings."
203 6. In the left pane, choose "General."
204 7. On the "General" tab in the "Paths" group, press the "Browse" button and
205 locate the MPlayer executable mplayer.exe.
206 8. In the "Output Device Driver" group, choose "kva" for "Video" and "dart"
207 for "Audio."
208 9. In the left pane, choose "Drives."
209 10. Under "Drives," select your CD-ROM and DVD drives.
210 11. In the left pane, go to "Subtitles."
211 12. On the "Font" tab in the "Font" group, you can either directly choose a
212 font file to use or select one of the fonts installed in your system:
213 * To select a specific font file, select the "TTF Font" radio button, press
214 "Browse," and locate the font file of the TrueType font you would like to
215 use for subtitles.
216 * To select an installed font, select the "System Font" radio button, press
217 "Choose," and select a TrueType font you would like to use for subtitles.
218 CAUTION: mplayer.exe will crash if you select a non-TrueType font!
219 13. To get prettier fonts, go to the "SSA/ASS Library" tab and enable the
220 option "Use SSA/ASS library for subtitle rendering." Optionally adjust the
221 color and font attributes.
222 14. Press OK to exit the settings dialog.
223
224If you have a slow machine, also do the following:
225
226 1. In the left pane, choose "Performance."
227 2. In the "Cache" group, enable the "Use cache" option.
228 3. Enable the "Skip frames" option.
229
230If you have a sound card that does not support 48kHz sampling rate, also do the
231following:
232
233 1. In the left pane, choose "Advanced."
234 2. In the "Audio Filter" entry field, enter:
235
236 resample=44100:0:1
237
238
2394. LICENSE, COPYRIGHT, DISCLAIMER
240=================================
241
242SMPlayer is copyright (C) 2006-2017 RVM <rvm@users.sourceforge.net>.
243
244The OS/2 port is copyright (c) 2008-2017 Silvan Scherrer.
245
246This program is free software; you can redistribute it and/or modify
247it under the terms of the GNU General Public License as contained in
248the file COPYING in the installation directory.
249
250The original source code is available at:
251
252 http://smplayer.sourceforge.net
253
254This program is distributed in the hope that it will be useful,
255but WITHOUT ANY WARRANTY; without even the implied warranty of
256MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
257
258For details, refer to the file COPYING.
259
260
2615. CONTACT
262==========
263
264If you find a bug, then add a ticket to the trac at
265http://svn.netlabs.org/qtapps
266
267Only bug reports with a reproducable bug are accepted. :-)
268
269
2706. CREDITS
271==========
272
273The port was done by:
274
275Silvan Scherrer aka _diver
276
277Thanks go to:
278
279 * Yuri Dario
280 * Doodle
281 * KO Myung-Hun
282 * Herwig Bauernfeind
283 * Christian Hennecke
284
285They either helped me when I had some nasty questions or did some testing for
286me.
287
288
2897. SUPPORT AND DONATIONS
290========================
291
292SMPlayer is based on volunteer work. If you would like to support further
293development, you can do so in one of the following ways:
294
295 * Donate to the Qt4 project: see http://qt.netlabs.org for more information
296
297 * Contribute to the project: Besides actual development, this also includes
298 maintaining the documentation and the project web site as well as help
299 for users.
300
301
3028. HISTORY
303==========
304
3052017-01-24
306 * updated to SMPlayer version 17.1.0
307
3082016-08-31
309 * updated to SMPlayer version 16.8.0
310
3112016-05-03
312 * updated to SMPlayer version 16.4.0
313
3142014-10-09
315 * updated to SMPlayer version 14.9.0
316 * add shortcuts to the zip file
317 * add themes to the zip file
318
3192014-05-15
320 * updated to SMPlayer version 14.3.0 (aka 0.8.7)
321
3222014-02-21
323 * updated to SMPlayer version 0.8.6
324
3252013-05-23
326 * updated to SMPlayer version 0.8.5
327
3282012-12-03
329 * updated to SMPlayer version 0.8.2
330
3312012-10-24
332 * updated to SMPlayer version 0.8.1
333
3342012-05-14
335 * updated to SMPlayer version 0.8.0
336
3372012-03-16
338 * updated to SMPlayer version 0.7.1
339
3402011-12-27
341 * updated to latest SMPlayer svn code
342
3432011-11-11
344 * updated to Qt 4.7.3
345 * fixed a possible hang when ending SMPlayer while playing a movie (patch by Rudi)
346
3472010-06-30
348 * fixed a nasty 1 second delay
349
3502010-04-29
351 * updated to Qt4 4.6.2
352 * added support for mplayer -ao kai (latest mplayer version)
353
3542010-01-29
355 * updated to latest Qt4 source
356 * enabled colorkey (thanks to KO Myung-Hun)
357
3582009-11-11
359 * fixed hang with broken media
360 * changed to Qt4 beta4
361
3622009-10-22
363 * removed requirement for MPlayer DLLs to be in PATH or SMPlayer directory
364 (fixed in Qt)
365 * removed requirement for C:\PSFONTS\helv.pfb (fixed in Qt)
366 * added Screensaver functionality for Doodle Screensaver
367
3682009-10-02
369 * beta1 of newest SMPlayer version with Qt4 support
370
3712009-01-22
372 * fixed a crash when playing audio files
373
3742008-11-24
375 * added french and german readme (done by Guillaume Gay and Christian Hennecke)
376 * added nice looking icons for exe and folder (done by David Graser)
377 * updated Qt DLL with newest version from SVN
378
3792008-11-04
380 * fixed a bug in Qt DLL which occured when playing from playlist
381 * renamed icon files to match wps behaviour
382
3832008-10-27
384 * with newest mplayer from hobbes the resizing problem is fixed
385 * fixed a bug introduced when adding more file extensions
386
3872008-10-20
388 * switched to custom-built Qt DLL sqt.dll (latest version from svn.netlabs.org/qt)
389 * added a couple more file extensions to the open file dialog
390
3912008-10-14
392 * initial release
Note: See TracBrowser for help on using the repository browser.