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

Last change on this file since 125 was 125, checked in by Silvan Scherrer, 13 years ago

SMPlayer: readme changes

File size: 10.4 KB
Line 
1SMPlayer _VERSION_ _BUILD_ README
2
3(W) Christian Hennecke, Oct 5, 2009
4last update March 19, 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
782.1 kLIBC, GCC4Core, Qt4
79------------------------
80
81
822.1.a RPM installation
83----------------------
84
85kLIBC
86-----
87
88 1. yum install libc
89
90GCC4Core
91--------
92
93 1. yum install libgcc
94 2. yum install gcc-stack-protector
95 3. yum install gcc-stdc++-shared-library
96 4. yum install gcc-supc++-shared-library
97
98Qt4 dll
99-------
100
101 1. yum install libqt4
102 2. Install the xsystray plugin as noted in the readme.os2 and also in
103 readme.xsystray
104
105
1062.1.b ZIP Installation
107----------------------
108
109kLIBC
110-----
111
112 1. Download kLIBC 0.6.4 or better (see http://svn.netlabs.org/libc for more
113 information)
114 2. Install the files to your libpath eg x:\ecs\dll
115
116GCC4Core
117--------
118
119 1. Download GCC4Core 1.2.1 or better from http://ftp.netlabs.org/pub/gcc
120 2. Install the files to your libpath eg. x:\ecs\dll
121
122Qt4 dll
123-------
124
125 1. Download Qt4 4.7.3 or better (see http://svn.netlabs.org/qt4 for more
126 information)
127 2. Install the files according to the readme
128 3. Install the xsystray plugin as noted in the readme.os2 and also in
129 readme.xsystray
130
131
1322.2 MPlayer, WIN32 codecs
133-------------------------
134
135MPlayer
136-------
137
138 http://hobbes.nmsu.edu/h-search.php?key=mplayer&pushbutton=Search
139
140 WARNING: To use the combination of SMPlayer and MPlayer to its full extent,
141 at least version mplayer-dev-SVN-r27724-OS2-4.3.2.zip is required.
142 Earlier versions do not support scaling, i.e., you will always
143 see a video in its original size, regardless of the zoom setting
144 or fullscreen mode.
145
146Win32 codecs (optional)
147-----------------------
148
149 http://www.mplayerhq.hu/design7/dload.html#binary_codecs
150
151 MPlayer is able to use Win32 codec DLLs for codecs it does not support
152 natively.
153
154
1553. INSTALLATION
156===============
157
158To install SMPlayer, do the following:
159
160MPlayer
161-------
162
163 1. Download a recent version of MPlayer.
164 2. Create a new directory for MPlayer.
165 3. Extract the MPlayer package to the new directory.
166 4. Copy the .mplayer subdirectory -- if included -- to your HOME directory.
167 5. To be able to use subtitles, copy a TrueType font of your choice to the
168 %HOME%\.mplayer directory and rename it to subfont.ttf.
169
170Win32 codecs
171------------
172
173 1. Download the codec package from the MPlayer site.
174 2. Go to the directory where you installed MPlayer and create a "codecs"
175 subdirectory.
176 3. Extract the package to the "codecs" subdirectory.
177 4. Add a SET MPLAYER_CODECS_DIR statement to your CONFIG.SYS, and point it
178 to the "codecs" subdirectory you create above.
179
180SMPlayer
181--------
182
183 1. Create a directory for SMPlayer. This will be called x:\smplayer below.
184 2. Extract the SMPlayer package to the new directory.
185 3. Create a WPS object for smplayer.exe
186 4. Start SMPlayer by double-clicking on the WPS object.
187 5. Open the settings dialog via "Options > Settings."
188 6. In the left pane, choose "General."
189 7. On the "General" tab in the "Paths" group, press the "Browse" button and
190 locate the MPlayer executable mplayer.exe.
191 8. In the "Output Device Driver" group, choose "kva" for "Video" and "dart"
192 for "Audio."
193 9. In the left pane, choose "Drives."
194 10. Under "Drives," select your CD-ROM and DVD drives.
195 11. In the left pane, go to "Subtitles."
196 12. On the "Font" tab in the "Font" group, you can either directly choose a
197 font file to use or select one of the fonts installed in your system:
198 * To select a specific font file, select the "TTF Font" radio button, press
199 "Browse," and locate the font file of the TrueType font you would like to
200 use for subtitles.
201 * To select an installed font, select the "System Font" radio button, press
202 "Choose," and select a TrueType font you would like to use for subtitles.
203 CAUTION: mplayer.exe will crash if you select a non-TrueType font!
204 13. To get prettier fonts, go to the "SSA/ASS Library" tab and enable the
205 option "Use SSA/ASS library for subtitle rendering." Optionally adjust the
206 color and font attributes.
207 14. Press OK to exit the settings dialog.
208
209If you have a slow machine, also do the following:
210
211 1. In the left pane, choose "Performance."
212 2. In the "Cache" group, enable the "Use cache" option.
213 3. Enable the "Skip frames" option.
214
215If you have a sound card that does not support 48kHz sampling rate, also do the
216following:
217
218 1. In the left pane, choose "Advanced."
219 2. In the "Audio Filter" entry field, enter:
220
221 resample=44100:0:1
222
223
2244. LICENSE, COPYRIGHT, DISCLAIMER
225=================================
226
227SMPlayer is copyright (C) 2006 - 2012 RVM <rvm@escomposlinux.org>.
228
229The OS/2 port is copyright (c) 2008, 2012 Silvan Scherrer.
230
231This program is free software; you can redistribute it and/or modify
232it under the terms of the GNU General Public License as contained in
233the file COPYING in the installation directory.
234
235The original source code is available at:
236
237 http://smplayer.sourceforge.net
238
239This program is distributed in the hope that it will be useful,
240but WITHOUT ANY WARRANTY; without even the implied warranty of
241MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
242
243For details, refer to the file COPYING.
244
245
2465. CONTACT
247==========
248
249If you find a bug, then add a ticket to the trac at
250http://svn.netlabs.org/qtapps
251
252Only bug reports with a reproducable bug are accepted. :-)
253
254
2556. CREDITS
256==========
257
258The port was done by:
259
260Silvan Scherrer aka _diver
261
262Thanks go to:
263
264 * Yuri Dario
265 * Doodle
266 * KO Myung-Hun
267 * Herwig Bauernfeind
268 * Christian Hennecke
269
270They either helped me when I had some nasty questions or did some testing for
271me.
272
273
2747. SUPPORT AND DONATIONS
275========================
276
277SMPlayer is based on volunteer work. If you would like to support further
278development, you can do so in one of the following ways:
279
280 * Donate to the Qt4 project: see http://qt.netlabs.org for more information
281
282 * Contribute to the project: Besides actual development, this also includes
283 maintaining the documentation and the project web site as well as help
284 for users.
285
286
2878. HISTORY
288==========
289
2902012-03-16
291 * updated to SMPlayer version 0.7.1
292
2932011-12-27
294 * updated to latest SMPlayer svn code
295
2962011-11-11
297 * updated to Qt 4.7.3
298 * fixed a possible hang when ending SMPlayer while playing a movie (patch by Rudi)
299
3002010-06-30
301 * fixed a nasty 1 second delay
302
3032010-04-29
304 * updated to Qt4 4.6.2
305 * added support for mplayer -ao kai (latest mplayer version)
306
3072010-01-29
308 * updated to latest Qt4 source
309 * enabled colorkey (thanks to KO Myung-Hun)
310
3112009-11-11
312 * fixed hang with broken media
313 * changed to Qt4 beta4
314
3152009-10-22
316 * removed requirement for MPlayer DLLs to be in PATH or SMPlayer directory
317 (fixed in Qt)
318 * removed requirement for C:\PSFONTS\helv.pfb (fixed in Qt)
319 * added Screensaver functionality for Doodle Screensaver
320
3212009-10-02
322 * beta1 of newest SMPlayer version with Qt4 support
323
3242009-01-22
325 * fixed a crash when playing audio files
326
3272008-11-24
328 * added french and german readme (done by Guillaume Gay and Christian Hennecke)
329 * added nice looking icons for exe and folder (done by David Graser)
330 * updated Qt DLL with newest version from SVN
331
3322008-11-04
333 * fixed a bug in Qt DLL which occured when playing from playlist
334 * renamed icon files to match wps behaviour
335
3362008-10-27
337 * with newest mplayer from hobbes the resizing problem is fixed
338 * fixed a bug introduced when adding more file extensions
339
3402008-10-20
341 * switched to custom-built Qt DLL sqt.dll (latest version from svn.netlabs.org/qt)
342 * added a couple more file extensions to the open file dialog
343
3442008-10-14
345 * initial release
Note: See TracBrowser for help on using the repository browser.