MovieCut: added italian translation.
[enigma2-plugins.git] / moviecut / Readme-MovieCut.txt
1 MovieCut-1.4
2 ------------
3 2012-02-26
4 Anders Holst (aho@sics.se)
5
6
7 This module makes it possible to execute the cuts specified by the
8 Cutlist editor in enigma2, 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.3
26
27 * Language support added (thanks, Thorsten Manthei). Initially only
28   with german and swedish, but more translations will hopefully
29   follow.
30
31 * Minor bug-fixes.
32
33
34 News since version 1.2
35
36 * The same mcut program can now cut movies on both DM7025 and
37   DM800/DM8000, and both normal and HD movies. There may still be some
38   flickering at the cut points, especially on DM800/DM8000, but rather
39   limited.
40
41 (* There is a driver change on DM7025 that makes movies cut with the
42    old mcut program (1.2 and earlier) to show much more flickering at
43    the cut points than before. Therefore you should change to he new
44    version, 1.3, even if you have only a DM7025 and thus no HD movies.)
45
46 * The mcut program now cuts the new .sc files too (making precise fast
47   forward and rewind possible), and copies the .eit as well (making
48   the info button work on cut movies).
49
50 * Some code cleanup.
51
52
53 News since version 1.1
54
55 * Nothing really is supposed to have changed functionally. However,
56   the plugin is updated to the skin changes of 2008-04-14, and the
57   location changes of 2008-06-28, and it uses eConsoleAppContainer
58   instead of spawnv/waitpid to launch "mcut".
59
60
61 News since version 1.0
62
63 * Cutting is still in the background, but now a notification will pop
64   up either when cutting is successfully finished, or with a suitable
65   error message if cutting fails.
66
67 * The cutting can now be done quite exact: If all cut marks are placed
68   at GOP boundaries (singlestep GOPs by pausing and pressing either
69   "rewind" or with the appropriate settings "pause"), then the
70   retained part will start with the same frame you were at when you
71   placed the IN cut, and it will stop just a few frames before
72   (typically 3 frames before - I can't easily get rid of this) the one
73   where you placed the OUT cut. Note however that due to a bug in
74   enigma2 (still there 2008-02-28) the CutListEditor will set the mark
75   at the right place, but when revisiting the mark you will end up one
76   GOP later. Trust the original mark position, not where it seems to
77   be when jumping to it.
78
79 * There are no flickering between cuts any more! There is a small (3
80   frames long) pause before the next cut starts, but all flickering
81   and squares seem to be gone. I believe this is as good as it can get
82   without remuxing.
83
84
85 Caveats
86
87 * The manual specification of cuts in the "advanced cut parameter"
88   dialogue is as awkward as before to specify with the remote control:
89   "0" is mapped to ".","0", and ":" since this was most
90   straightforward to implement using existing python code. Also note
91   that the cuts are given in pairs of *included* sections, not
92   *excluded* as in the cutlist editor (i.e. there is first an IN time,
93   followed by OUT, and so on).
94
95 * There may still be occasional flickering at the cut points, at least
96   on some platforms and for some services. It is hard to do much
97   better without remuxing.
98
99
100 Disclaimer
101
102 I have really tried to be careful and make it reasonably "safe": It
103 checks for errors during the process and will abort in a controlled
104 way if it happens; If "-r"="replace" is specified, it will not remove
105 any files until the whole cutting is successfully done; if "-r" is not
106 given it will not overwrite any existing file with the same name as the
107 destination; if no cuts are specified nothing will be done; etc.
108
109 However, all use will be on your own risk. I will not take
110 responsibility for any damage or loss of movies or other files due to
111 either bugs in the program or uncareful use. 
112