HMT File Format - Revision history

Prpr: Correct endian-ness of BST offset value.

2018-09-18T00:11:01Z

Correct endian-ness of BST offset value.

2016-05-19T15:27:48Z

Update flags in byte 0x028E

2016-01-03T16:47:34Z

2016-01-03T16:35:54Z

2016-01-03T14:47:56Z

2015-11-25T22:34:56Z

‎Custom Firmware Extensions

2015-11-08T23:02:12Z

2015-11-08T23:01:17Z

2015-08-29T17:16:49Z

2015-07-21T13:07:21Z

Updated description for 0x288 and 0x28c

@@ Line 32: / Line 32: @@
 x03E5	string	74 chars max.		Guide text for Media list.(only if guide is on).
 x0431	1 byte	0x00			Number of copies allowed when 'Copy Limited' flag is set in 0x3DC
-x0434	2 byte	0x2211                  Daylight Savings seconds offset. 0x100E = BST,  0x0000 = GMT
+x0434	2 byte	0x2211                  Daylight Savings seconds offset. 0x0E10 = BST,  0x0000 = GMT
 x0458	4 byte	0x44332211		Channel number.
 x045C	1 byte	0x15			String header.

@@ Line 17: / Line 17: @@
 	bit 0	00000001		On-Disk Encrypted flag. 1 = Encrypted. 0 = Decrypted
 	bit 1	00000010		Thumbnail exists flag. 1 = Yes. 0 =  No
 x0290  1 byte  00           		Failed recording code - see table below.
 x0294	4 bytes	0x44332211		Played time in seconds (used by resume). 0x00 if unplayed or played to end.
@@ Line 126: / Line 128: @@
 x02BC	4 byte	0xC0320000		12288 (0x3000) + 704. Byte offset to start of next EPG block.
 </pre>
 === Fields ===
 <pre>

@@ Line 38: / Line 38: @@
 X048C	2 byte	0x2211			Originating Network ID (ONID).
 x048E	2 byte	0x2211			Program Map Table (PMT) PID.
-x0490	2 bytes	0x2211			Video PID.
+x0490	2 bytes	0x2211			Video PID for TV recording, or Audio PID for radio recording.
-x0493	1 byte	0x20			Constant.
+x0492	2 bytes	0x0020			Constant.
-x0494	2 bytes	0x2211			Video PID.
+x0494	2 bytes	0x2211			Video PID, or 0x0020 for radio recording.
-x0498	1 byte	0x11			Video Type MPEG2=0x01,  H264=0x02.
+x0498	1 byte	0x11			Video Type MPEG2=0x01, H264=0x02, Radio-0x00.
-x049C	2 bytes 0x2211			Audio PID.
+x049C 	2 bytes 0x2211			Audio PID for both TV and radio recordings.
 x04A0	1 byte	0x00			Audio Type MPEG=0x01 AC3=0x03 AAC=0x07.
 x04A5	1 byte	0x20			Constant.
-x04AD	1 byte	0x20			Constant
+x04AD	1 byte	0x20			Constant.
-x04B8	1 byte	0x01			Constant??
+x04B8	1 byte	0x01			Recording type. 0x01=TV, 0x02=Radio.
-x04BC	1 byte	0x00			Video type flag for Media list. 0x01 = SD. 0x02 = HD.
+x04BC	1 byte	0x00			Video type flag for Media list. 0x01 = SD. 0x02 = HD, 0x00 = Radio.
-x04C0	1 byte	0x01			Constant ??
+x04C0	1 byte	0x01			Constant.
-x04C4	1 byte	0xFF			Constant ??
+x04C4	1 byte	0xFF			Constant.
 x04F8	4 byte	0x44332211		Program scheduled start date & time (Epoch format).
 x04FC	4 bytes	0x44332211		Program scheduled duration (seconds).

@@ Line 23: / Line 23: @@
 x031C	4 bytes				Start of bookmark table. Maximum 32  x 4 byte entries (seconds from start).
 x03DC	1 byte	0x00			Flags byte.
-	bit 1	00000010		'Copy Allowed' flag. 0 = unlimited copies. If set, number of allowed copies is in offset 0x431
+	bit 1	00000010		'Copy Limited' flag. 0 = Unlimited copies. If set, copy count limit is in offset 0x431.
-	bit 2	00000100		'Encrypted' flag. 1 = Decryption allowed.Used to determine if decryption on copy to USB is allowed.
+	bit 2	00000100		'Encrypted' flag. 1 = Decryption allowed. Determines if decryption on copy to USB is allowed.
 x03E0	1 byte				Media list Guidance Type - see table below.
 x03E1  1 byte				Media list Guidance Mode - see table below.
 x03E2	1 byte	0x15			String header (only if guide is on).
 x03E5	string	74 chars max.		Guide text for Media list.(only if guide is on).
-x0431	1 byte	0x00			Number of copies allowed when Unlimited Copies' flag is zero in 0x3DC
+x0431	1 byte	0x00			Number of copies allowed when 'Copy Limited' flag is set in 0x3DC
 x0434	2 byte	0x2211                  Daylight Savings seconds offset. 0x100E = BST,  0x0000 = GMT
 x0458	4 byte	0x44332211		Channel number.

@@ Line 23: / Line 23: @@
 x031C	4 bytes				Start of bookmark table. Maximum 32  x 4 byte entries (seconds from start).
 x03DC	1 byte	0x00			Flags byte.
-	bit 1	00000010		'Encrypted' flag. 1 = Encrypted. Used to determine if decryption on copy to USB is allowed.
+	bit 1	00000010		'Copy Allowed' flag. 0 = unlimited copies. If set, number of allowed copies is in offset 0x431
-	bit 2	00000100		'Copy Allowed' flag. 1 = copy allowed. (If zero, Number of allowed copies is in offset 0x431)
+	bit 2	00000100		'Encrypted' flag. 1 = Decryption allowed.Used to determine if decryption on copy to USB is allowed.
 x03E0	1 byte				Media list Guidance Type - see table below.
 x03E1  1 byte				Media list Guidance Mode - see table below.

@@ Line 185: / Line 185: @@
 <pre>
 x0010  1 byte                          Series number.
-x0011  1 bytes                         Episode number.
+x0011  1 byte                          Episode number.
 x073D	4 bytes 0x656E6700		Null terminated string 'eng'
          First character 'E' indicates recording has been shrunk.

@@ Line 125: / Line 125: @@
 x026A	string 74 chars max.		Guide text for iPlate (only if guide is on).
 x02BC	4 byte	0xC0320000		12288 (0x3000) + 704. Byte offset to start of next EPG block.
+</pre>
 Guidance Flag
 -------------

@@ Line 1: / Line 1: @@
-See also update notes below
+=== Standard .hmt file format ===
 <pre>
 Offset	Size				Content
 ------  -----   ----------------------------------  Header Block, Size 0x1004 (4100) bytes ---------------------------------------------
 x0000	2 byte	0x1701			Constant.
-x0000	126 byte			All Nulls.Constant
+x0002	126 bytes			All Nulls. Constant.
 x0080	string	254 byte max		Recording file path e.g. "/media/sda1/My Video/" (not needed when creating hmt)
 x0180	string	256 byte max		Recording  date-extended file name e.g. "The One Show_21010816_1817"
@@ Line 179: / Line 178: @@
 Additional information provided by af123 and GrahamCobb.
 </pre>
 Notes by escat :-
 *The file name field has moved from offset 017F to 0180. Both variants may be found depending on the age of the recording. Although the Humax software doesn't appear to use this field, other CF packages may do so. For example, af123 has already modified the hmt utility to accommodate this change. However, the Nicesplice package still appears to create hmt files with the old format, even when the original recording had the new format.

@@ Line 8: / Line 8: @@
 x0080	string	254 byte max		Recording file path e.g. "/media/sda1/My Video/" (not needed when creating hmt)
 x0180	string	256 byte max		Recording  date-extended file name e.g. "The One Show_21010816_1817"
-x0280	4 byte	0x11223344		Recording start time (Epoch format)
+x0280	4 byte	0x44332211		Recording start time (Epoch format)
-x0284	4 byte	0x11223344		Recording end   time (Epoch format)
+x0284	4 byte	0x44332211		Recording end   time (Epoch format)
 x0288	4 byte	0x44332211              Recording duration in seconds - set but not used by HumaxTV(?), uses End-Start instead
 x028C	1 byte	0x02			Recording 00=zero length, 01=Recording in progress/power loss, 02=valid, 03=scrambled, 04=failed

@@ Line 10: / Line 10: @@
 x0280	4 byte	0x11223344		Recording start time (Epoch format)
 x0284	4 byte	0x11223344		Recording end   time (Epoch format)
-x0288	4 byte	0x00000000
+x0288	4 byte	0x44332211              Recording duration in seconds - set but not used by HumaxTV(?), uses End-Start instead
-x028C	1 byte	0x02			Recording 00=zero length, 02=valid, 03=scrambled, 04=failed
+x028C	1 byte	0x02			Recording 00=zero length, 01=Recording in progress/power loss, 02=valid, 03=scrambled, 04=failed
 x028D	1 byte	0x00			Flags byte.
 	bit 2	00000100		'Locked' flag. 1 = Locked.