source: smplayer/trunk/readme.os2@ 104

Last change on this file since 104 was 104, checked in by Silvan Scherrer, 15 years ago

smplayer: 0.6.9

File size: 9.7 KB
Line 
1SMPlayer _VERSION_ _BUILD_ README
2
3(W) Christian Hennecke, Oct 5, 2009
4last update Jan 29, 2010
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
76* klibc 0.6.3 or later
77
78 ftp://ftp.netlabs.org/pub/gcc/libc-0_6_3-csd3.wpi
79
80* Qt4 dll
81
82 ftp://ftp.netlabs.org/pub/qt4/qt-lib-4_5_1-xx.wpi (exchange xx with the most current available)
83 if GA is available it's in it's own subdir 4.5.1-ga
84
85* MPlayer
86
87 http://hobbes.nmsu.edu/h-search.php?key=mplayer&pushbutton=Search
88
89 WARNING: To use the combination of SMPlayer and MPlayer to its full extent,
90 at least version mplayer-dev-SVN-r27724-OS2-4.3.2.zip is required.
91 Earlier versions do not support scaling, i.e., you will always
92 see a video in its original size, regardless of the zoom setting
93 or fullscreen mode.
94
95* Win32 codecs (optional)
96
97 http://www.mplayerhq.hu/design7/dload.html#binary_codecs
98
99 MPlayer is able to use Win32 codec DLLs for codecs it does not support
100 natively.
101
102
1033. INSTALLATION
104===============
105
106To install SMPlayer, do the following:
107
108klibc
109-----
110
111 1. Download klibc 0.6.3 csd3 or later.
112 2. Install the package by double-clicking on the WPI file.
113
114
115Qt4 dll
116-------
117
118 1. Download the package
119 2. Extract all dll to your libpath. preferable x:\ecs\dll or x:\os2\dll where x: is your boot drive
120 3. Install the xsystray plugin as noted in the readme.os2 and also in readme.xsystray
121
122
123MPlayer
124-------
125
126 1. Download a recent version of MPlayer.
127 2. Create a new directory for MPlayer.
128 3. Extract the MPlayer package to the new directory.
129 4. Copy the .mplayer subdirectory -- if included -- to your HOME directory.
130 4. To be able to use subtitles, copy a TrueType font of your choice to the
131 %HOME%\.mplayer directory and rename it to subfont.ttf.
132
133
134Win32 codecs
135------------
136
137 1. Download the codec package from the MPlayer site.
138 2. Go to the directory where you installed MPlayer and create a "codecs"
139 subdirectory.
140 3. Extract the package to the "codecs" subdirectory.
141 4. Add a SET MPLAYER_CODECS_DIR statement to your CONFIG.SYS, and point it
142 to the "codecs" subdirectory you create above.
143
144
145SMPlayer
146--------
147
148 1. Create a directory for SMPlayer. This will be called x:\smplayer below.
149 2. Extract the SMPlayer package to the new directory.
150 3. Create a WPS object for smplayer.exe
151 4. Start SMPlayer by double-clicking on the WPS object.
152 5. Open the settings dialog via "Options > Settings."
153 6. In the left pane, choose "General."
154 7. On the "General" tab in the "Paths" group, press the "Browse" button and
155 locate the MPlayer executable mplayer.exe.
156 8. In the "Output Device Driver" group, choose "kva" for "Video" and "dart"
157 for "Audio."
158 9. In the left pane, choose "Drives."
159 10. Under "Drives," select your CD-ROM and DVD drives.
160 11. In the left pane, go to "Subtitles."
161 12. On the "Font" tab in the "Font" group, you can either directly choose a
162 font file to use or select one of the fonts installed in your system:
163 * To select a specific font file, select the "TTF Font" radio button, press
164 "Browse," and locate the font file of the TrueType font you would like to
165 use for subtitles.
166 * To select an installed font, select the "System Font" radio button, press
167 "Choose," and select a TrueType font you would like to use for subtitles.
168 CAUTION: mplayer.exe will crash if you select a non-TrueType font!
169 13. To get prettier fonts, go to the "SSA/ASS Library" tab and enable the
170 option "Use SSA/ASS library for subtitle rendering." Optionally adjust the
171 color and font attributes.
172 14. Press OK to exit the settings dialog.
173
174If you have a slow machine, also do the following:
175
176 1. In the left pane, choose "Performance."
177 2. In the "Cache" group, enable the "Use cache" option.
178 3. Enable the "Skip frames" option.
179
180If you have a sound card that does not support 48kHz sampling rate, also do the
181following:
182
183 1. In the left pane, choose "Advanced."
184 2. In the "Audio Filter" entry field, enter:
185
186 resample=44100:0:1
187
188
1894. LICENSE, COPYRIGHT, DISCLAIMER
190=================================
191
192SMPlayer is copyright (C) 2006 - 2007 RVM <rvm@escomposlinux.org>.
193
194The OS/2 port is copyright (c) 2008, 2010 Silvan Scherrer.
195
196This program is free software; you can redistribute it and/or modify
197it under the terms of the GNU General Public License as contained in
198the file COPYING in the installation directory.
199
200The original source code is available at:
201
202 http://smplayer.sourceforge.net
203
204Changes for the OS/2 version are included in the file:
205
206 smplayer.diff (not included in the beta)
207
208This program is distributed in the hope that it will be useful,
209but WITHOUT ANY WARRANTY; without even the implied warranty of
210MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
211
212For details, refer to the file COPYING.
213
214
2155. CONTACT
216==========
217
218Please send bugreports to:
219
220 ecs@aroa.ch
221
222Only bug reports with a reproducable bug are accepted. :-)
223
224Please enclose the error.log file that is produced with the setup described
225above under INSTALLATION.
226
227
2286. CREDITS
229==========
230
231The port was done by:
232
233Silvan Scherrer aka _diver
234
235Thanks go to:
236
237 * Yuri Dario
238 * Doodle
239 * KO Myung-Hun
240 * Herwig Bauernfeind
241 * Christian Hennecke
242
243They either helped me when I had some nasty questions or did some testing for
244me.
245
246
2477. SUPPORT AND DONATIONS
248========================
249
250SMPlayer is based on volunteer work. If you would like to support further
251development, you can do so in one of the following ways:
252
253 * Donate to the Qt4 project: see http://qt.netlabs.org for more information
254
255 * Contribute to the project: Besides actual development, this also includes
256 maintaining the documentation and the project web site as well as help
257 for users.
258
259
2608. HISTORY
261==========
262
2632010-04-29
264 * updated to Qt4 4.6.2
265 * added support for mplayer -ao kai (latest mplayer version)
266
2672010-01-29
268 * updated to latest Qt4 source
269 * enabled colorkey (thanks to KO Myung-Hun)
270
2712009-11-11
272
273 * fixed hang with broken media
274 * changed to Qt4 beta4
275
2762009-10-22
277
278 * removed requirement for MPlayer DLLs to be in PATH or SMPlayer directory
279 (fixed in Qt)
280 * removed requirement for C:\PSFONTS\helv.pfb (fixed in Qt)
281 * added Screensaver functionality for Doodle Screensaver
282
2832009-10-02
284
285 * beta1 of newest smplayer version with Qt4 support
286
2872009-01-22
288
289 * fixed a crash when playing audio files
290
2912008-11-24
292
293 * added french and german readme (done by Guillaume Gay and Christian Hennecke)
294 * added nice looking icons for exe and folder (done by David Graser)
295 * updated Qt DLL with newest version from SVN
296
2972008-11-04
298
299 * fixed a bug in Qt DLL which occured when playing from playlist
300 * renamed icon files to match wps behaviour
301
3022008-10-27
303
304 * with newest mplayer from hobbes the resizing problem is fixed
305 * fixed a bug introduced when adding more file extensions
306
3072008-10-20
308
309 * switched to custom-built Qt DLL sqt.dll (latest version from svn.netlabs.org/qt)
310 * added a couple more file extensions to the open file dialog
311
3122008-10-14
313
314 * initial release
315
Note: See TracBrowser for help on using the repository browser.