label -> statictext,
[enigma2-plugins.git] / moviecut / Readme-MovieCut-1.2.txt
1 MovieCut-1.2
2 ------------
3 2008-07-17
4 Anders Holst (aho@sics.se)
5
6
7 This module makes it possible to execute the cuts specified by the
8 Cutlist editor on DM7025, i.e. the specified sections are actually
9 removed from the file, saving disk space and simplifying if the movie
10 is to be e.g. burned to a DVD. When installed it will be accessible
11 from the file list menu (i.e. selecting a file in the file list and
12 pressing the menu button) under the name "Execute cuts...". First use
13 the Cutlist editor to set the appropriate cut marks. Then select 
14 "Execute cuts..." and it will give some options for usage.
15
16 The real work is done by the program "mcut". It was inspired and
17 guided by the similar package "moviecutter" bu Georges. However, you
18 need not wait over the night but it can run in the background as you
19 keep watching on your dreambox, and a typical movie takes about 15-20
20 minutes to process. The program "mcut" can also be called directly
21 from a shell. With no arguments it will give a brief description of
22 the options.
23
24
25 News since version 1.1
26
27 * Nothing really is supposed to have changed functionally. However,
28   the plugin is updated to the skin changes of 2008-04-14, and the
29   location changes of 2008-06-28, and it uses eConsoleAppContainer
30   instead of spawnv/waitpid to launch "mcut".
31
32
33 News since version 1.0
34
35 * Cutting is still in the background, but now a notification will pop
36   up either when cutting is successfully finished, or with a suitable
37   error message if cutting fails.
38
39 * The cutting can now be done quite exact: If all cut marks are placed
40   at GOP boundaries (singlestep GOPs by pausing and pressing either
41   "rewind" or with the appropriate settings "pause"), then the
42   retained part will start with the same frame you were at when you
43   placed the IN cut, and it will stop just a few frames before
44   (typically 3 frames before - I can't easily get rid of this) the one
45   where you placed the OUT cut. Note however that due to a bug in
46   enigma2 (still there 2008-02-28) the CutListEditor will set the mark
47   at the right place, but when revisiting the mark you will end up one
48   GOP later. Trust the original mark position, not where it seems to
49   be when jumping to it.
50
51 * There are no flickering between cuts any more! There is a small (3
52   frames long) pause before the next cut starts, but all flickering
53   and squares seem to be gone. I believe this is as good as it can get
54   without remuxing.
55
56
57 Caveats
58
59 * Since some time in the spring 2008 there seems to be a change/bug in
60   enigma2 that makes the elapsed time calculation somewhat offset
61   compared to earlier. This appears such that cut marks placed with
62   earlier versions appears to have drifted when watched in the new
63   version of enigma2. MovieCut is still callibrated to the earlier
64   calculation, and may thus also place the cuts somewhat offset from
65   the intended places. Always cut to a new file and check the result
66   to be on the safe side!
67
68 * The manual specification of cuts in the "advanced cut parameter"
69   dialogue is as awkward as before to specify with the remote control:
70   "0" is mapped to ".","0", and ":" since this was most
71   straightforward to implement using existing python code. Also note
72   that the cuts are given in pairs of *included* sections, not
73   *excluded* as in the cutlist editor (i.e. there is first an IN time,
74   followed by OUT, and so on).
75
76 * Although the flickering between cuts may be gone when looking at the
77   movie on the dreambox, there is no guarantee that they are gone when
78   trying to convert it to mpeg for burning to DVD or similar. It is
79   not even guaranteed that they can be easily converted at all - at
80   least one program is reported to fail to continue after the first
81   cut.
82
83
84 Disclaimer
85
86 I have really tried to be careful and make it reasonably "safe": It
87 checks for errors during the process and will abort in a controlled
88 way if it happens; If "-r"="replace" is specified, it will not remove
89 any files until the whole cutting is successfully done; if "-r" is not
90 given it will not overwrite any existing file with the same name as the
91 destination; if no cuts are specified nothing will be done; etc.
92
93 However, all use will be on your own risk. I will not take
94 responsibility for any damage or loss of movies or other files due to
95 either bugs in the program or uncareful use. 
96