PUZ (crossword puzzles)

From Just Solve the File Format Problem
(Difference between revisions)
Jump to: navigation, search
(Format documentation)
Line 4: Line 4:
 
|extensions={{ext|puz}}
 
|extensions={{ext|puz}}
 
}}
 
}}
The '''PUZ''' crossword puzzle data format (unrelated to the [[PUZ]] document format used by Microsoft Publisher) is a format used for electronically-distributed crossword puzzles. It was created for the Across Lite program, and became a de facto standard for online crosswords, including the popular ''New York Times'' puzzles. No official file format documentation was provided (the producers probably would have preferred it remain proprietary), but it has been reverse-engineered and is now used in many crossword programs and apps. For a long time, reverse-engineered implementations were unable to decode the "scrambled" version of the file format, where the correct answers to the puzzle are encrypted with a four-digit key needed to unlock them (you can still do the puzzle without unscrambling the answers, as the grid layout and clues are not encrypted, but have no way of checking your answers), but eventually somebody reverse-engineered that as well (a tour-de-force of computer science and mathematics by Brian Raiter, linked below; Mike Richards apparently also discovered the algorithm as documented in comments in another of the links below).
+
The '''PUZ''' crossword puzzle data format (unrelated to the [[PUZ]] document format used by Microsoft Publisher) is a format used for electronically-distributed crossword puzzles. It was created for the Across Lite program, and became a de facto standard for online crosswords, including the popular ''New York Times'' puzzles. No official file format documentation was provided (the producers probably would have preferred it remain proprietary), but it has been reverse-engineered and is now used in many crossword programs and apps (though perhaps not so many after some more recent saber-rattling by the legal department of the owner of the originating program). For a long time, reverse-engineered implementations were unable to decode the "scrambled" version of the file format, where the correct answers to the puzzle are encrypted with a four-digit key needed to unlock them (you can still do the puzzle without unscrambling the answers, as the grid layout and clues are not encrypted, but have no way of checking your answers), but eventually somebody reverse-engineered that as well (a tour-de-force of computer science and mathematics by Brian Raiter, linked below; Mike Richards apparently also discovered the algorithm as documented in comments in another of the links below).
  
 
Across Lite also has a "text format" of puzzles, which can be used to create puzzles which the Across Lite program can convert into the binary format for distribution. Unlike the binary format itself, the publisher of Across Lite has documented that format to allow third parties to use it.
 
Across Lite also has a "text format" of puzzles, which can be used to create puzzles which the Across Lite program can convert into the binary format for distribution. Unlike the binary format itself, the publisher of Across Lite has documented that format to allow third parties to use it.

Revision as of 14:09, 16 February 2014

File Format
Name PUZ (crossword puzzles)
Ontology
Extension(s) .puz

The PUZ crossword puzzle data format (unrelated to the PUZ document format used by Microsoft Publisher) is a format used for electronically-distributed crossword puzzles. It was created for the Across Lite program, and became a de facto standard for online crosswords, including the popular New York Times puzzles. No official file format documentation was provided (the producers probably would have preferred it remain proprietary), but it has been reverse-engineered and is now used in many crossword programs and apps (though perhaps not so many after some more recent saber-rattling by the legal department of the owner of the originating program). For a long time, reverse-engineered implementations were unable to decode the "scrambled" version of the file format, where the correct answers to the puzzle are encrypted with a four-digit key needed to unlock them (you can still do the puzzle without unscrambling the answers, as the grid layout and clues are not encrypted, but have no way of checking your answers), but eventually somebody reverse-engineered that as well (a tour-de-force of computer science and mathematics by Brian Raiter, linked below; Mike Richards apparently also discovered the algorithm as documented in comments in another of the links below).

Across Lite also has a "text format" of puzzles, which can be used to create puzzles which the Across Lite program can convert into the binary format for distribution. Unlike the binary format itself, the publisher of Across Lite has documented that format to allow third parties to use it.

After an acquisition in 2011, the owners of Across Lite are reportedly getting more aggressive in enforcing whatever intellectual property rights they may claim to have in the format, which could cause trouble for reverse-engineers. Other alternative puzzle formats include JPZ and IPUZ, the latter of which is explicitly designated a "free format".

Contents

Identification

Starting at the third byte (position 02), files have the ASCII string "ACROSS&DOWN" followed by a null byte, giving it the byte signature 41 43 52 4f 53 53 26 44 4f 57 4e 00. The first two bytes are a checksum, one of several that exist within the file format.

Format documentation

Software

Utilities

Other links

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox