|
14801
|
1 README for the TOOLS directory
|
|
|
2 ==============================
|
|
|
3
|
|
|
4 Preamble
|
|
|
5 --------
|
|
|
6
|
|
|
7 In this directory you can find some nice scripts and code that makes
|
|
|
8 using MPlayer and MEncoder easier, for example scripts for DVD track
|
|
|
9 encoding in three pass mode or creating SVCDs from a movie.
|
|
|
10
|
|
|
11 MPlayer scripts in the TOOLS dir
|
|
|
12 --------------------------------
|
|
|
13
|
|
|
14 midentify
|
|
|
15
|
|
|
16 Author: Tobias Diedrich
|
|
|
17
|
|
|
18 Description: Runs 'mplayer -identify' for all arguments while preventing
|
|
|
19 video window flashing.
|
|
|
20
|
|
|
21 Usage: midentify file1 [file2 ...]
|
|
|
22
|
|
|
23
|
|
|
24 mpconsole
|
|
|
25
|
|
|
26 Author: Rich Felker
|
|
|
27
|
|
|
28 Description: Script to run MPlayer on the console (fbdev/mga_vid/etc.) without
|
|
|
29 the console text and/or flashing cursor getting in the way.
|
|
|
30
|
|
|
31 Usage: mpconsole [mplayer options]
|
|
|
32
|
|
|
33
|
|
|
34 mplmult.sh
|
|
|
35
|
|
|
36 Author: Reimar Döffinger
|
|
|
37
|
|
|
38 Description: Example how to output video on multiple windows in sync. Might
|
|
|
39 be even more useful in combination with -vo ggi to distribute
|
|
|
40 the video arbitrarily.
|
|
|
41
|
|
|
42 Usage: mplmult.sh <n> <options>
|
|
|
43 n number of MPlayer instances that display the video
|
|
|
44 options any options you would pass to MPlayer, more than
|
|
|
45 one file will usually not work
|
|
|
46
|
|
|
47
|
|
|
48 x2mpsub.sh
|
|
|
49
|
|
|
50 Author: Gabucino
|
|
|
51
|
|
|
52 Description: Converts the subtitles in the current directory into MPsub
|
|
|
53 format (subtitles go in ./converted-subtitles/).
|
|
|
54
|
|
|
55 Usage: x2mpsub.sh
|
|
|
56
|
|
|
57
|
|
|
58 mp.pl
|
|
|
59
|
|
|
60 Author: Felix Bünemann
|
|
|
61
|
|
|
62 Description: Small helper script that allows to play multiple files with
|
|
|
63 MPlayer. Wildcards are supported.
|
|
|
64
|
|
|
65 Usage: mp.pl <parameters> <files>
|
|
|
66 Where <parameters> are all possible command line switches
|
|
|
67 for MPlayer and <files> can be either a list of files,
|
|
|
68 like file1 file2 file3 and/or a wildcard definition,
|
|
|
69 like *.avi.
|
|
|
70
|
|
|
71 example: mp.pl -vo x11 /dvd/VIDEO_TS/VTS_05_*.VOB movie.asf
|
|
|
72
|
|
|
73
|
|
|
74 wma2ogg.pl
|
|
|
75
|
|
|
76 Author: Peter Simon
|
|
|
77
|
|
|
78 Description: Converts WMA files to Ogg or MP3.
|
|
|
79
|
|
|
80 Usage: wma2ogg [options] <-f FILE1 | -f FILE2 ... | -a>
|
|
|
81 -f, -file filename
|
|
|
82 -a converts all WMA files in the current directory
|
|
|
83 -t output filetype (ogg, mp3) [default=ogg]
|
|
|
84 -lame I wanna use L.A.M.E. sure enough!
|
|
|
85 -br bitrate (kb/s) [default=from the WMA]
|
|
|
86 -del remove WMA file(s) after the transcoding
|
|
|
87
|
|
|
88
|
|
|
89
|
|
|
90 MEncoder scripts in the TOOLS dir
|
|
|
91 ---------------------------------
|
|
|
92
|
|
|
93 divx2svcd
|
|
|
94
|
|
|
95 Author: Miklos Vajna
|
|
|
96
|
|
|
97 Description: A simple utility that creates an SVCD from a video in an AVI
|
|
|
98 container.
|
|
|
99
|
|
|
100 Usage: divx2svcd <input_avi> [options]
|
|
|
101 see 'divx2svcd -h' for more info
|
|
|
102
|
|
|
103
|
|
|
104 mencvcd
|
|
|
105
|
|
|
106 Author: Jürgen Hammelmann
|
|
|
107
|
|
|
108 Description: Converts DVD (or anything else that MPlayer plays) to (S)VCD
|
|
|
109
|
|
|
110 Usage: mencvcd <basename> [mencvcd options] [mplayer options]
|
|
|
111 see 'mencvcd -h' for more info
|
|
|
112
|
|
|
113 Note: Requires MPlayer, mjpegtools, VCDImager, cdrdao, and optionally
|
|
|
114 LAME, tooLAME and SoX.
|
|
|
115
|
|
|
116
|
|
|
117 dvd2divxscript.pl
|
|
|
118
|
|
|
119 Author: Florian Schilhabel
|
|
|
120
|
|
|
121 Description: Yet another DVD to divx helper script.
|
|
|
122 This script encodes a DVD track in three pass mode to MPEG-4 with
|
|
|
123 libavcodec. Optionally it writes the resulting movie file to
|
|
|
124 CD-ROM the corresponding audio track to MP3. It can also shut
|
|
|
125 down the computer when it finishes. If you like, you can
|
|
|
126 watch the MEncoder output on /dev/tty8.
|
|
|
127
|
|
|
128 Usage: --help show help
|
|
|
129 --abr (AudioBitRate) Please enter the desired bitrate this
|
|
|
130 can be either [96|128|192] kbit/sec (default: 128).
|
|
|
131 --lang Specify the Language of the audio track this can be
|
|
|
132 for example <en> or <de> (default: <de>).
|
|
|
133 --dvd Specify the DVD track you want to encode.
|
|
|
134 --cdsize Specify the size of your CD-ROM (default: 700MB).
|
|
|
135 --shutdown Shutdown the system, when the encoding process has
|
|
|
136 finished. Needs appropriate privileges.
|
|
|
137 --out Specify the name of your encoded movie. The file
|
|
|
138 extension will be appended automatically.
|
|
|
139 --writecd Takes the newly created movie and writes it to a
|
|
|
140 CD-ROM.
|
|
|
141 --writedev cdrecord device identifier, for example 0,1,0
|
|
|
142 --speed writing speed (default: 4)
|
|
|
143 --dvd-device device to pull the video off (default: /dev/dvd)
|
|
|
144
|
|
|
145
|
|
|
146
|
|
|
147 Tech scripts in the TOOLS dir
|
|
|
148 -----------------------------
|
|
|
149
|
|
|
150 fastmem.sh
|
|
|
151
|
|
|
152 Author: Arpi
|
|
|
153
|
|
|
154 Description: benchmark/testbed for fastmemcpy stuff
|
|
|
155
|
|
|
156 Usage: fastmem.sh
|
|
|
157
|
|
|
158
|
|
|
159 sws-test
|
|
|
160
|
|
|
161 Author: Michael Niedermayer
|
|
|
162
|
|
|
163 Description: Very simple script to generate PNG images from a video with all
|
|
|
164 -sws methods.
|
|
|
165
|
|
|
166 Usage: sws-test <video-file> <start-pos> <res>
|
|
|
167
|
|
|
168 example: sws-test abc.avi 10 160:120
|
|
|
169
|
|
|
170
|
|
|
171 calcbpp.pl
|
|
|
172
|
|
|
173 Author: Moritz Bunkus
|
|
|
174
|
|
|
175 Description: A script that calculates the $bpp for a movie, mentioned in
|
|
|
176 DOCS/tech/encoding-tips.txt, see that document for more info.
|
|
|
177
|
|
|
178 Usage: calcbpp.pl <resolution> <aspect ratio> <bitrate> <fps>
|
|
|
179 resolution: the cropped but unscaled resolution
|
|
|
180 (use '-vf cropdetect')
|
|
|
181 aspect ratio: the encoded aspect ratio. All DVDs come at
|
|
|
182 720x576 but contain a flag that tells the player
|
|
|
183 wether it should display the DVD at an aspect
|
|
|
184 ratio of 4/3 (1.333) or at 16/9 (1.777). Have a
|
|
|
185 look at MPlayer's output - there's something
|
|
|
186 about 'prescaling'. That's what you are looking
|
|
|
187 for.
|
|
|
188 bitrate: the video bitrate in kbit/s
|
|
|
189 fps: the fps
|
|
|
190
|
|
|
191 example: calcbpp.pl 720x440 16/9 896 25
|
|
|
192
|
|
|
193
|
|
|
194 countquant.pl
|
|
|
195
|
|
|
196 Author: Moritz Bunkus
|
|
|
197
|
|
|
198 Description: Counts the quantizers used for the encoding, mentioned in
|
|
|
199 DOCS/tech/encoding-tips.txt, see that document for more info.
|
|
|
200
|
|
|
201 Usage: countquant.pl < divx2pass.log
|
|
|
202 It will print out which quantizer was used how often. If you see
|
|
|
203 that e.g. the lowest quantizer (vqmin=2) gets used for > 95% of
|
|
|
204 the frames then you can safely increase your picture size.
|
|
|
205
|
|
|
206
|
|
|
207 perlbench.pl
|
|
|
208
|
|
|
209 Author: Felix Bünemann
|
|
|
210
|
|
|
211 Description: fastmemcpy benchmark script
|
|
|
212
|
|
|
213 Usage: perlbench.pl
|
|
|
214
|
|
|
215
|
|
|
216 plotpsnr.pl
|
|
|
217
|
|
|
218 Author: Jonas Jermann
|
|
|
219
|
|
|
220 Description: Draw PSNR log graphs using gnuplot.
|
|
|
221
|
|
|
222 Usage: plotpsnr.pl [options] <file>
|
|
|
223 -h, --help Display this help message
|
|
|
224 -quant Display quantizers
|
|
|
225 -size Display size
|
|
|
226 -psnr Display PSNR
|
|
|
227 -iframes Display I-frames
|
|
|
228 -pframes Display P-frames
|
|
|
229 -bframes Display B-frames
|
|
|
230 -aframes Display all frames in different colors
|
|
|
231 -cmp <file2> Compare two files
|
|
|
232 -qs <style> Quantizer style
|
|
|
233 -ss <style> Size style
|
|
|
234 -ps <style> PSNR style
|
|
|
235
|
|
|
236 Default: -quant -size -psnr -qs "p" -ss "i" -ps "p"
|
|
|
237
|
|
|
238 Note: Requires gnuplot. Comparison is based on file2. Comparison
|
|
|
239 assumes that the frame numbers of both files fit.
|
|
|
240
|
|
|
241
|
|
|
242 asfinfo
|
|
|
243
|
|
|
244 Author: Arpi
|
|
|
245
|
|
|
246 Description: a simple ASF header display program
|
|
|
247
|
|
|
248 Usage: asfinfo <filename.asf>
|
|
|
249
|
|
|
250 Note: Also see MPlayer's -identify option.
|
|
|
251
|
|
|
252
|
|
|
253 avi-fix
|
|
|
254
|
|
|
255 Author: Arpi
|
|
|
256
|
|
|
257 Description: A simple tool to fix chunk sizes in RIFF AVI files.
|
|
|
258
|
|
|
259 Usage: avi-fix [-fix] <badfile.avi>
|
|
|
260
|
|
|
261 Note: It does not check or fix the index, to do this use
|
|
|
262 'mencoder -forceidx -oac copy -ovc copy'.
|
|
|
263
|
|
|
264
|
|
|
265 bios2dump
|
|
|
266
|
|
|
267 Author: Nick Kurshev
|
|
|
268
|
|
|
269 Description: Extract your PC BIOS and save it to file.
|
|
|
270
|
|
|
271 Usage: As argument requires DOS interrupt number in hexadecimal form.
|
|
|
272 As output - will write 64KB file which will named:
|
|
|
273 SSSS_OOOO.intXX
|
|
|
274 where: SSSS - segment of BIOS interrupt handler
|
|
|
275 OOOO - offset of BIOS interrupt handler
|
|
|
276 XX - interrupt number which was passed as argument
|
|
|
277
|
|
|
278
|
|
|
279 cpuinfo
|
|
|
280
|
|
|
281 Author: Jürgen Keil
|
|
|
282
|
|
|
283 Description: the prototype ../cpuinfo.c
|
|
|
284
|
|
|
285 Note: Used by configure to emulate /proc/cpuinfo on non-Linux systems.
|
|
|
286
|
|
|
287
|
|
|
288 dump_mp4
|
|
|
289
|
|
|
290 Author: Arpi
|
|
|
291
|
|
|
292 Description: MPEG4-ES stream inspector, dumps the stream startcodes.
|
|
|
293
|
|
|
294
|
|
|
295 fastmemcpybench
|
|
|
296
|
|
|
297 Author: Felix Bünemann
|
|
|
298
|
|
|
299 Description: benchmark/testbed for fastmemcpy stuff
|
|
|
300
|
|
|
301 Note: Also see fastmem.sh.
|
|
|
302
|
|
|
303
|
|
|
304 mem2dump
|
|
|
305
|
|
|
306 Author: Nick Kurshev
|
|
|
307
|
|
|
308 Description: Dump memory block to file.
|
|
|
309
|
|
|
310 Usage: As argument requires absolute address of memory dump and its
|
|
|
311 length (in hexadecimal form).
|
|
|
312 As output - will write file which will be named:
|
|
|
313 memADDR_LEN.dump
|
|
|
314 where: ADDR - given address of memory
|
|
|
315 LEN - given length of memory
|
|
|
316
|
|
|
317
|
|
|
318 movinfo
|
|
|
319
|
|
|
320 Author: Arpi
|
|
|
321
|
|
|
322 Description: Show QuickTime MOV file structure.
|
|
|
323
|
|
|
324 Usage: movinfo <filename.mov>
|
|
|
325
|
|
|
326
|
|
|
327 png2raw
|
|
|
328
|
|
|
329 Author: Arpi
|
|
|
330
|
|
|
331 Description: PNG to RAW image converter, used by .raw font creators.
|
|
|
332
|
|
|
333 Usage: png2raw <file1> [file2...]
|
|
|
334
|
|
|
335
|
|
|
336 vivodump
|
|
|
337
|
|
|
338 Author: Arpi
|
|
|
339
|
|
|
340 Description: Dump H.263 frame headers from VIVO files.
|
|
|
341
|
|
|
342 Usage: vivodump <input_file> <output_file>
|
|
|
343
|
|
|
344
|
|
|
345 Miscellaneous scripts in the TOOLS dir
|
|
|
346 --------------------------------------
|
|
|
347
|
|
|
348 subedit.pl
|
|
|
349
|
|
|
350 Author: Michael Klepikov
|
|
|
351
|
|
|
352 Description: A script for pipelined editing of subtitle files.
|
|
|
353
|
|
|
354 Usage: subedit.pl [switches]
|
|
|
355 -if,--input-format <fmt> input format; supported: SRT (default: SRT)
|
|
|
356 -of,--output-format <fmt> output format; supported: SRT
|
|
|
357 (default: input format)
|
|
|
358 -s,--shift <time> shift all subtitles by <time>
|
|
|
359 (format: [-]hh:mm:ss,fraction)
|
|
|
360 -c,--scale <time> scale by adding <time> to overall duration
|
|
|
361 -f,--split-from <time> drop subtitles that end before <time>
|
|
|
362 -t,--split-to <time> drop subtitles that start after <time> (will
|
|
|
363 truncate timing if it overlaps a boundary)
|
|
|
364 -r,--renumber renumber SRT subtitles in output
|
|
|
365 -d,--debug enable debug output
|
|
|
366 -h,--help help message
|
|
|
367
|
|
|
368
|
|
|
369 w32codec_dl.pl
|
|
|
370
|
|
|
371 Author: Tom Lees
|
|
|
372
|
|
|
373 Description: This script will use the Windows Media Player codec download
|
|
|
374 infrastructure to aquire the codecs listed in codecs.conf and put
|
|
|
375 them in a directory named "codecs/" below the current directory.
|
|
|
376
|
|
|
377 Usage: w32codec_dl.pl <codecs.conf location>
|
|
|
378
|
|
|
379 Note: You will need the libwww-perl stuff and the cabextract utility
|
|
|
380 which can be found at http://www.kyz.uklinux.net/cabextract.php3.
|
|
|
381
|
|
|
382
|
|
|
383 subrip.c
|
|
|
384
|
|
|
385 Author: Kim Minh Kaplan
|
|
|
386
|
|
|
387 Description: Transform VOBsub subtitles into Subrip text subtitles using
|
|
|
388 GOCR/JOCR.
|
|
|
389
|
|
|
390 Usage: subrip <vobsub basename> [subid [output filename] ]
|
|
|
391
|
|
|
392 Note: Requires at least JOCR/GOCR 0.37.
|
|
|
393 You will have to change the 'vobsub_id' value if you want a
|
|
|
394 subtitle different from number 0. Hint: You can view the
|
|
|
395 subtitle that is being decoded with "display subtitle-*.pgm".
|
|
|
396
|
|
|
397
|
|
|
398 alaw-gen.c
|
|
|
399
|
|
|
400 Author: Arpi
|
|
|
401
|
|
|
402 Description: Generates alaw/ulaw tables.
|
|
|
403
|
|
|
404 Note: Created to work around a past license issue, no longer useful.
|
