Set the cut path properly when a non-default output path is specified
[atscap.git] / atscap.NEWS
blob69b5461053c81151da934f8c7c8cc82409e56422
1 NEWS for atscap 1.1 release candidates
2 ------------------------------------------------------------------------------
3         Have feedback from users that it's working with many DVB-API ATSC
4     devices other than pcHDTV cards. The new name reflects the generic ATSC
5     support via the Linux DVB-API drivers vs. deprecated V4L in pchdtvr.
7         The documentation man pages are mostly done, too.
9         The new web UI design allows using it with generic browsers.
11         The main complaint about the console being hard to use should now
12     be resolved with the new http interface. If I did it right, that is.
13     All you need is mozilla/firefox for point and click playback and editing.
14     
15         The http user interface has no provision for full capture yet. This
16     is probably something the user wants to do from the console, anyway.
17     In some cases, full cap can work around issues with single VC parsing,
18     so user can sort out what to do with the full cap after it has completed.
20         Even a modest 1.6 GHz machine should be able to play 4 SD MPEG streams
21     at the same time. Use player to figure out which audio for mute/listen.
22     I can play 1 HD *or* 4 SD streams on 1.6 GHz AMD 2000XP machine, not both.
24         While html EPG refresh has been tweaked to cause as little delay for
25     the player machine as possible, there are still a lot of CPU cycles, once
26     every 30m, that are required on both server and client to refresh the EPG
27     page. The best way avoid it is to be on a page that does not auto-refresh,
28     such as the server main page (with scan off) or the capture directory.
30         I finally managed testing it on an old slow p2/350 machine. It works.
31     It should also work fine with SpeedStep or Cool-n-Quiet in low gear.
32     CPU usage is so low, < 20% p2/350, and under < 3% on AMD 2000XP,
33     that it should stay in the lowest CPU frequency range for new CPUs.
38 CABLE IS SUPPORTED (non-encrypted streams only, almost useless without EPG):
40         Cable setup is done with:
42                 atscap -F[1-5] -S
44         -F1 to -F5 selects which frequency table to use. See man atscap.
45     The local Comcast system here seems to work OK with -F2 or -F4.
47         Cable systems have problems. Encryption hinders most studies.
48     Satellite users with unencrypted channels may have better luck.
51 CABLE HAS ODD PROGRAM MAP TABLES:
53         atscap -S will only validate PMT programs on cable that do not have
54     Conditional Access descriptors and that use Elementary Stream Type 2.
55     User Private Streams are not validated by atscap -S, nor are the 
56     streams that have the scramble bit set.
59 CABLE HAS NO EPG:
61         Haven't seen any ATSC PSIP EPG data on cable. Still looking. There
62     are new config options to use broadcast EPGs for broadcast via cable.
63     Stations that have no EPG will require user to manually enter timers.
66 IMPORTING BROADCAST EVENT PROGRAM GUIDES:
68         Use S .conf file option to tell it address:port of atscap server to
69     fetch the guides from during test_epgs. Two extra C line fields let you
70     translate Program X from broadcast EPG Y to use for the cable VC EPG.
71     This allow the use of the typical broadcast EPG control via console or
72     web brower that you would see if you were using broadcast.
75 MANUAL WEEKDAY OR VOLATILE TIMERS:
77         The above only helps for broadcast stations via cable. For stations
78     that have no EPG, you will have to enter weekday or volatile timers,
79     either via [t] key on console or editing the config file. The volatile
80     timer format is easier to enter now, with something like this:
82         V2:20070812:16:00:60:StargateSG1@.3
84         where V2 is the logical channel #2 and .3 is program #3.
85     It will be converted into machine readable format on next save config.
88 TWO DEVICES OR THE ATSCAP BUDDY SYSTEM FOR IMPORTING BROADCAST EPG DATA:
90         Until there is a way to import the EPGs for the cable-only stations,
91     it will be limited to old-style VCR functionality. If you have two DVB
92     devices, atscap can use one of them for broadcast EPG load and serve
93     the EPG files to the cable-connected device. If you don't have two DVB
94     devices but have a local broadcast-only buddy that is running atscap,
95     you can fetch the broadcast EPGs from your buddy's machine. You will
96     need to co-ordinate your configuration with the EPG numbers your
97     buddy is using for his atscap session.
99         Sharing one device between broadcast and cable, i.e. using some
100     kind of antenna selector, is not supported but could be added.
103 ADDITIONAL CONFIG FILE:
105         /etc/atscap/atscap[0-3].tsid.[qam/vsb] holds TSIDs detected by
106     atscap -S, and also during normal capture operations. The only ones
107     kept are non-scrambled channels with detectable video. This file is a
108     new helper file to save some typing the next time you use atscap -S.
110         Cable has very few in-stream callsigns (MPEG TS PMT Component Names)
111     so you'll have to edit callsign and sid fields for this file to be able
112     to retain them the next time you run atscap -S. You'll have to do
113     captures on each reported TS-XXXX channel to figure out what it is.
114     This also applies for broadcast if they're not sending proper ATSC PSIP.
117 EDITING CAPTURES:
119         One last item about cable: xtscut will cut the files, even SD caps,
120     but this may be specific to the cable provider encoders. Some are known
121     to send streams that do not align Sequence Starts at TS Payload Starts.
122     atscap -m won't generate any .tsx files in this case, so you'll have to
123     use other editing software, like ProjectX, for these streams. Also, some
124     SD streams have fewer than 1 I-frame per second. The cuts are wide.
126         For better cuts, keep in mind that the captures are very similar
127     to MPEG TS camcorder output. If you have software, such as Liquid, for
128     your camcorder, it might work for more accurate frame-by-frame cutting,
129     No idea if Liquid can handle the A/52 audio. Camcorders use MPEG audio.
133 DRIVER ISSUES WITH USE_POWERDOWN:
135         *** USE_POWERDOWN ** is experimental, expect problems and tell me.
137 TESTME: My latest HD3000 fault-tolerant driver with hardware i2c and reset
138     does power control via open/close. Older drivers would fail trying that.
139     It's not very fast but seems to work well even with software i2c.
140     Power down is done by holding down CX88_EXT_RESET pin on cx88 chip.
141     Power up is done 30s before any timers or test epg starts.
143 RESULTS: It seems to run cooler and not use the fault-tolerant code anymore.
144     I have not seen the HD3000 go 5 days without needing reset until this fix.
145     There is mention in DVB API spec about cable/sat demodulators overheating.
146     Apparently overheating applies to terrestrial demodulators as well.