mytube: migrate most of the functionality (except authentication and everything relat...
[enigma2-plugins.git] / reconstructapsc / Readme-ReconstructApSc.txt
1 ReconstructApSc-1.0
2 -------------------
3 2009-12-14
4 Anders Holst (aho@sics.se)
5
6
7 This plugin makes it possible to reconstruct missing or corrupt .ap
8 and .sc files of recorded movies. These files are used for precise
9 seeking and winding in the movie, and also for finding the cut
10 positions when using the plugin MovieCut to cut movies. 
11
12 Situations when this plugin may be useful include:
13  * The .sc files are relatively new, so movies recorded with Enigma2
14    from before the spring of 2009 doesn't have them.
15  * The previous version of MovieCut did not know about .sc, and
16    therefore produced no such file for the resulting cut movie.
17  * If you have cut your movies on a PC, you may not get any .ap or .sc
18    files. 
19  * If a specific movie is impossible to seek correctly in, or just
20    gets black or a frozen picture when trying to fast forward or
21    rewind, then one may suspect that the coresponding .ap and .sc
22    have got corrupt for some reason.
23  * When downloading ts-files from internet, there may not be any
24    provided .ap and .sc.
25  * After a disk crash it may be possible to rescue the .ts files
26    (because their specific structure) but perhaps not the others.
27
28 The plugin uses the C++ program "reconstruct_apsc" to scan through the
29 .ts file, and store the structural information into the .ap and .sc
30 files. You can either tell the program to reconstruct the files for a
31 specific movie, in which case any existing .ap and .sc for that movie
32 will be removed first. Or, you can tell it to reconstruct all files in
33 a specific directory, in which case it only reconstructs missing .ap
34 and .sc files. The typical situation is that you have a directory with
35 many older movies that don't have any .sc files. Note that
36 reconstructing .sc files for all movies in a directory may take
37 considerable time and disk activity. If the process should be
38 interupted for some reason, it should however be able to continue from
39 there next time you start it.
40
41 Disclaimer
42
43 I have tried to be careful, and to make it reasonably safe to use: It
44 should never change or overwrite the actual .ts file, but only the .ap
45 and .sc files; It checks for errors during the process and will abort
46 in a controlled way if it happens; It remembers which file it was
47 processing if it gets interupted so it can start from there next time,
48 not leaving any half-finished .ap or .sc.
49
50 However, all use will be on your own risk. I will not take
51 responsibility for any damage or loss of movies or other files due to
52 either bugs in the program or uncareful use. 
53