source: smplayer/trunk/os2/readme.os2@ 178

Last change on this file since 178 was 176, checked in by Silvan Scherrer, 9 years ago

smplayer: update trunk to version 16.4

File size: 11.2 KB
Line 
1SMPlayer _VERSION_ _BUILD_ README
2
3(W) Christian Hennecke, Oct 5, 2009
4last update May 3, 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-2016 RVM <rvm@users.sourceforge.net>.
243
244The OS/2 port is copyright (c) 2008-2016 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
3052016-05-03
306 * updated to SMPlayer version 16.4.0
307
3082014-10-09
309 * updated to SMPlayer version 14.9.0
310 * add shortcuts to the zip file
311 * add themes to the zip file
312
3132014-05-15
314 * updated to SMPlayer version 14.3.0 (aka 0.8.7)
315
3162014-02-21
317 * updated to SMPlayer version 0.8.6
318
3192013-05-23
320 * updated to SMPlayer version 0.8.5
321
3222012-12-03
323 * updated to SMPlayer version 0.8.2
324
3252012-10-24
326 * updated to SMPlayer version 0.8.1
327
3282012-05-14
329 * updated to SMPlayer version 0.8.0
330
3312012-03-16
332 * updated to SMPlayer version 0.7.1
333
3342011-12-27
335 * updated to latest SMPlayer svn code
336
3372011-11-11
338 * updated to Qt 4.7.3
339 * fixed a possible hang when ending SMPlayer while playing a movie (patch by Rudi)
340
3412010-06-30
342 * fixed a nasty 1 second delay
343
3442010-04-29
345 * updated to Qt4 4.6.2
346 * added support for mplayer -ao kai (latest mplayer version)
347
3482010-01-29
349 * updated to latest Qt4 source
350 * enabled colorkey (thanks to KO Myung-Hun)
351
3522009-11-11
353 * fixed hang with broken media
354 * changed to Qt4 beta4
355
3562009-10-22
357 * removed requirement for MPlayer DLLs to be in PATH or SMPlayer directory
358 (fixed in Qt)
359 * removed requirement for C:\PSFONTS\helv.pfb (fixed in Qt)
360 * added Screensaver functionality for Doodle Screensaver
361
3622009-10-02
363 * beta1 of newest SMPlayer version with Qt4 support
364
3652009-01-22
366 * fixed a crash when playing audio files
367
3682008-11-24
369 * added french and german readme (done by Guillaume Gay and Christian Hennecke)
370 * added nice looking icons for exe and folder (done by David Graser)
371 * updated Qt DLL with newest version from SVN
372
3732008-11-04
374 * fixed a bug in Qt DLL which occured when playing from playlist
375 * renamed icon files to match wps behaviour
376
3772008-10-27
378 * with newest mplayer from hobbes the resizing problem is fixed
379 * fixed a bug introduced when adding more file extensions
380
3812008-10-20
382 * switched to custom-built Qt DLL sqt.dll (latest version from svn.netlabs.org/qt)
383 * added a couple more file extensions to the open file dialog
384
3852008-10-14
386 * initial release
Note: See TracBrowser for help on using the repository browser.