ProjectX - Revision history

Bc at 17:16, 30 June 2007

2007-06-30T17:16:14Z

Bukka at 13:23, 5 September 2006

2006-09-05T13:23:53Z

Bc at 18:19, 16 May 2006

2006-05-16T18:19:55Z

Bc at 22:50, 7 April 2006

2006-04-07T22:50:59Z

Bc at 23:14, 6 April 2006

2006-04-06T23:14:43Z

Bc at 22:38, 6 April 2006

2006-04-06T22:38:44Z

New page

'''ProjectX''' is a useful tool for de-multiplexing Transport Streams (.ts files). Typically it is used to process files captured with [[DVB]] cards. ProjectX has many useful features, but an intuitive user friendly interface isn't one of them.

==Downloading==

Download the latest version from Doom9's website (do not download it from the ProjectX website!):

* http://www.doom9.org/index.html?/software.htm

ProjectX is written in Java so you will need to have a Java VM installed on your computer too:

*http://java.com/getjava

==Configuring for first use==

#Extract the all files from the zip file and run ProjectX.jar.
#Go to the ''View'' menu and change the look and feel to the one you feel most comfortable with.
#Go to the ''PreSettings'' menu and select ''PreSettings''
#Go to the ''output'' tab and deselect ''Teletext'', ''Subpicture'', and ''Generic_VBI''.
#Go to the ''audio'' tab and deselect ''delete CRC in MPEG-Audio Layer1,2''.
#Close the ''PreSettings'' window.
#Click on the ''prepare >>'' button on the main window.
#Go to the ''Edit'' menu and select ''process all collections'' and close the ''ProcessWindow'' window.

==Usage==

[[Image:ProjectX_tut1.png]]

#Drag and drop files onto the window marked with '''A''' or click on the ''+'' button next to '''A''' to browse for files. If you want to de-multiplex more that one file at a time click on the ''+'' button next to '''B''' to create a new collection and you next file. Do not add more than one file to each collection unless you want the files in each collection to be joined together when de-multiplexing (you probably don't want to ever do this). If the files you are adding are audio only you might get a ''cannot find sequence header'' error in the preview window which can be safely ignored.
#Click on the ''+'' button by '''C''' and choose an output folder.
#Press the ''QucikStart'' button.

==Checking ProjectX log files for errors==

ProjectX will produce a log file for each collection which contains import information about any Transport Stream errors it might have encountered whilst de-multiplexing. This will alert you to any dropouts that have occurred, thus saving you the embarrassment of uploading a crap file.

Below is a portion of a log from a Transport Stream that contained errors:

!> PID 0x2C2 (PMT) (376 #3) -> ignored
!> PID 0x12 (EIT) (752 #5) -> ignored
!> PID 0x0 (PAT) (8836 #48) -> ignored
ok> PID 0x1B0 has PES-ID 0xC0 (MPEG Audio) (9212 #50)
!> PID 0x14 (TOT) (21056 #113) -> ignored
!> PID 0x11 (SDT) (73132 #390) -> ignored
!> PID 0x10 (NIT) (365848 #1947) -> ignored
<span style="color:red">!> PID 0x1B0 -> packet 435135 @ pos. 81805192 out of sequence (7/3) (shifting..) (~00:00:00.000)</span>
!> incomplete ts packet at EOF detected @ 230378960
packs: 446246 100% 230379132

--> MPEG Audio (0xC0) on PID 0x1B0
-> check CRC of AC-3 / MPEG-Audio L1,2
-> add frames
Audio PTS: first packet 11:28:10.812, last packet 12:33:05.148
-> adjusting audio at its own timeline
-> src_audio: MPEG-1, Layer2, 48000Hz, jstereo, 160kbps, CRC @ 00:00:00.000
<span style="color:red">!> missing syncword @ 27653281, @ 00:23:02.664
!> found syncword @ 27653636
!> missing syncword @ 27655557, @ 00:23:02.760
!> found syncword @ 27655680
!> 9 frame(s) (216ms) inserted @ 00:23:02.760
!> 2 frame(s) (48ms) inserted @ 00:23:03.120</span>
audio frames: wri/pre/skip/ins/add 162272/0/0/11/0 @ 01:04:54.528 done...
-> 538 stereo/jointstereo change(s) detected...
---> new File: 'D:\demux\(2006-03-25) Dub Bashment.mp2'

In this example ProjectX was unable to recover 216ms of audio 23 minutes and 2.76 seconds into the stream, and a further 48ms at 23:03.120. By default missing audio is replaced with silence to ensure the audio stream remains the same length it would have been had it contained no errors.

:Sometimes you will see a warning about a packet being out of sequence in the first part of the log, but get no missing syncword errors/frames inserted in audio section. This is because not all packets contain audio data, and the error will be affecting a different stream instead (if your Transport Stream contains a video stream there will be section in your log for video errors). Often Transport Streams will contain few small data streams that you are probably aren't interested in, therefore errors in these probably don't matter.

Below is an example of a portion of a log from an error free Transport Stream:

ok> PID 0x1842 has PES-ID 0xC0 (MPEG Audio) (376 #3)
!> PID 0x12 (EIT) (752 #5) -> ignored
!> PID 0x0 (PAT) (9400 #51) -> ignored
!> PID 0x106 (PMT) (10152 #55) -> ignored
!> PID 0x14 (TOT) (21620 #116) -> ignored
!> PID 0x11 (SDT) (64108 #342) -> ignored
!> PID 0x10 (NIT) (93436 #498) -> ignored
!> incomplete ts packet at EOF detected @ 439238500
packs: 1040243 100% 439238656

--> MPEG Audio (0xC0) on PID 0x1842
-> check CRC of AC-3 / MPEG-Audio L1,2
-> add frames
Audio PTS: first packet 09:08:02.225, last packet 11:12:51.809
-> adjusting audio at its own timeline
-> src_audio: MPEG-1, Layer2, 48000Hz, stereo, 192kbps, CRC @ 00:00:00.000
audio frames: wri/pre/skip/ins/add 312072/0/0/0/0 @ 02:04:49.728 done...
---> new File: 'D:\demux\(2006-03-28) Breezeblock.mp2'

==Dealing with errors==

Todo.

[[category:Audio_Tools]]

← Older revision		Revision as of 13:23, 5 September 2006
Line 115:		Line 115:

	Generally it is best to only use this method when you already have already de-multiplexed using one of the other methods so that you know how big the gaps were, and untick it when you've finished.		Generally it is best to only use this method when you already have already de-multiplexed using one of the other methods so that you know how big the gaps were, and untick it when you've finished.
		+
		+
		+	==External Links==
		+
		+	*http://www.doom9.org/index.html?/software.htm
		+	*http://java.com/getjava

	[[category:Audio_Tools]]		[[category:Audio_Tools]]

@@ Line 1: / Line 1: @@
-'''ProjectX''' is a useful tool for de-multiplexing Transport Streams (.ts files). Typically it is used to process files captured with [[DVB]] cards. ProjectX has many useful features, but an intuitive user friendly interface isn't one of them.
+'''ProjectX''' is a useful tool for de-multiplexing Transport Streams (.ts files). Typically it is used to process files captured with [[DVB]] cards. ProjectX has many useful features, but an intuitive user friendly interface isn't one of them. This guide is written for demultiplexing radio shows, and therefore does not cover many of ProjectX's video features.
 ==Downloading==
@@ Line 65: / Line 65: @@
 In this example ProjectX was unable to recover 216ms of audio 23 minutes and 2.76 seconds into the stream, and a further 48ms at 23:03.120. By default missing audio is replaced with silence to ensure the audio stream remains the same length it would have been had it contained no errors.
-:Sometimes you will see a warning about a packet being out of sequence in the first part of the log, but get no missing syncword errors/frames inserted in audio section. This is because not all packets contain audio data, and the error will be affecting a different stream instead (if your Transport Stream contains a video stream there will be section in the log file for video errors). Often Transport Streams will contain few small data streams that you are probably aren't interested in, and therefore errors in these probably don't matter.
+:Sometimes you will see a warning about a packet being out of sequence in the first part of the log, but get no missing syncword errors/frames inserted in audio section. This is because not all packets contain audio data, and the error will be affecting a different stream instead (if your Transport Stream contains a video stream there will be section in the log file for video errors). Often Transport Streams will contain some data streams that you are probably aren't interested in, and therefore errors in these probably don't matter.
 Below is a portion of a log from an error free Transport Stream:

@@ Line 65: / Line 65: @@
 In this example ProjectX was unable to recover 216ms of audio 23 minutes and 2.76 seconds into the stream, and a further 48ms at 23:03.120. By default missing audio is replaced with silence to ensure the audio stream remains the same length it would have been had it contained no errors.
-:Sometimes you will see a warning about a packet being out of sequence in the first part of the log, but get no missing syncword errors/frames inserted in audio section. This is because not all packets contain audio data, and the error will be affecting a different stream instead (if your Transport Stream contains a video stream there will be section in thelog for video errors). Often Transport Streams will contain few small data streams that you are probably aren't interested in, and therefore errors in these probably don't matter.
+:Sometimes you will see a warning about a packet being out of sequence in the first part of the log, but get no missing syncword errors/frames inserted in audio section. This is because not all packets contain audio data, and the error will be affecting a different stream instead (if your Transport Stream contains a video stream there will be section in the log file for video errors). Often Transport Streams will contain few small data streams that you are probably aren't interested in, and therefore errors in these probably don't matter.
 Below is a portion of a log from an error free Transport Stream:
@@ Line 88: / Line 88: @@
   ---> new File: 'D:\demux\(2006-03-28) Breezeblock.mp2'
-==Dealing with errors==
+==Dealing with audio errors==
-Todo.
+There is no way to recover missing audio that has occurred due to packet errors, however there are several different methods for dealing with the gaps.
 [[category:Audio_Tools]]

@@ Line 120: / Line 120: @@
 *http://www.doom9.org/index.html?/software.htm
 *http://java.com/getjava
 [[category:Audio_Tools]]

@@ Line 26: / Line 26: @@
 [[Image:ProjectX_tut1.png]]
-#Drag and drop files onto the window marked with '''A''' or click on the ''+'' button next to '''A''' to browse for files. If you want to de-multiplex more that one file at a time click on the ''+'' button next to '''B''' to create a new collection and you next file. Do not add more than one file to each collection unless you want the files in each collection to be joined together when de-multiplexing (you probably don't want to ever do this). If the files you are adding are audio only you might get a ''cannot find sequence header'' error in the preview window which can be safely ignored.
+#Drag and drop files onto the window marked with '''A''' or click on the ''+'' button next to '''A''' to browse for files. If you want to de-multiplex more than one file at a time click on the ''+'' button next to '''B''' to create a new collection and you next file. Do not add more than one file to each collection unless you want the files in each collection to be joined together when de-multiplexing (you probably don't want to ever do this). If the files you are adding are audio only you might get a ''cannot find sequence header'' error in the preview window which can be safely ignored.
 #Click on the ''+'' button by '''C''' and choose an output folder.
 #Press the ''QucikStart'' button.
@@ Line 32: / Line 32: @@
 ==Checking ProjectX log files for errors==
-ProjectX will produce a log file for each collection which contains import information about any Transport Stream errors it might have encountered whilst de-multiplexing. This will alert you to any dropouts that have occurred, thus saving you the embarrassment of uploading a crap file.
+ProjectX will produce a log file for each collection which contains important information about any Transport Stream errors it might have encountered whilst de-multiplexing. This will alert you to any dropouts that have occurred, thus saving you the embarrassment of uploading a crap file.
-Below is a portion of a log from a Transport Stream that contained errors:
+Below is a portion of a log from a Transport Stream that contained errors (the red parts indicate the errors):
   !> PID 0x2C2 (PMT) (376 #3) -> ignored
@@ Line 65: / Line 65: @@
 In this example ProjectX was unable to recover 216ms of audio 23 minutes and 2.76 seconds into the stream, and a further 48ms at 23:03.120. By default missing audio is replaced with silence to ensure the audio stream remains the same length it would have been had it contained no errors.
-:Sometimes you will see a warning about a packet being out of sequence in the first part of the log, but get no missing syncword errors/frames inserted in audio section. This is because not all packets contain audio data, and the error will be affecting a different stream instead (if your Transport Stream contains a video stream there will be section in your log for video errors). Often Transport Streams will contain few small data streams that you are probably aren't interested in, therefore errors in these probably don't matter.
+:Sometimes you will see a warning about a packet being out of sequence in the first part of the log, but get no missing syncword errors/frames inserted in audio section. This is because not all packets contain audio data, and the error will be affecting a different stream instead (if your Transport Stream contains a video stream there will be section in thelog for video errors). Often Transport Streams will contain few small data streams that you are probably aren't interested in, and therefore errors in these probably don't matter.
-Below is an example of a portion of a log from an error free Transport Stream:
+Below is a portion of a log from an error free Transport Stream:
   ok> PID 0x1842 has PES-ID 0xC0 (MPEG Audio) (376 #3)