- This is a fully populated nzb file, all the tags and attributes you can expect to see are there, but clients are expected to cope should more be added. Since this is an XML format, clients are encouraged to use an XML parser to process it; minor changes to the nzb files we generate such as with attribute ordering, indentation, and even new tags.
- With this release the code has been cleaned up and optimized thanks to a patch by Roland Pabel, thank you! New features include possibility to ignore SSL errors (makes nzb work with servers that use self-signed certificates), ability to select multiple files in the list and enable/disable download of these items.
- NZB Drop is a sophisticated Usenet downloading utility, specifically designed to work with.nzb files, a new file format used to identify binaries posted to Usenet newsgroups.
Nzb Drop V2 43 Magazines
Mirrored from the now defunct docs.newzbin.com. References to 'We' throughout the document should be assumed to be referring to Newzbin, not SABnzbd.
NZB Drop v4 Blazing NZB downloads for OS X. Download Buy Now. Download files, nothing else. No more climbing through mountains of headers. Bypass usenet clutter and get directly to the content you want. Unified interface. Manage all your nzb files and downloads from one browser window. See screenshots below.
NZB (Message-ID List) File Specification
Here follows a sample NZB for a single small file:
This example is for one file, consisting of two segments, which are 102,394 bytes and 4,501 bytes. The file is posted into two groups, alt.binaries.newzbin and alt.binaries.mojo; it was posted by Joe Bloggs, at unixtime 1071674882. The subject is slightly munged; the segment counter always starts at 1; but you can see it has 2 segments; confirmed by the segments tags below.
This is a fully populated nzb file, all the tags and attributes you can expect to see are there, but clients are expected to cope should more be added.
Since this is an XML format, clients are encouraged to use an XML parser to process it; minor changes to the nzb files we generate such as with attribute ordering, indentation, and even new tags and attributes must be taken into account. XML PI's and CDATA sections are not expected to be used, so clients should be free to cut some corners using lightweight parsers.
We will, where possible, avoid changes which may break clients; even those which use simple pattern matchers. Significant changes to the format are unlikely at this point, but users of the format should try not to get too complacent.
XML Tag breakdown
Nzb Drop V2 43 Ultra
<nzb> . </nzb> | |
---|---|
Description | Root element for the NZB |
Attributes | None |
Body | None (placeholder) |
Children | <head>, <file> |
<head> . </head> | |
---|---|
Description | Contains all metadata relating to contents of NZB |
Attributes | None |
Body | None |
Children | <meta> |
<meta> . </meta> | |
---|---|
Description | Creator-definable metadata for the contents of the NZB (e.g. title) |
Attributes | typestring - Identifier for the metadata content |
Body | string - The metadata content corresponding to the given type |
Children | None |
<file> . </file> | ||
---|---|---|
Description | Represents a list of messageids that make up a file | |
Attributes | poster | string - Copy of the From: field from the article header. |
date | int - Unixtime representation of the date the server saw this article. This is not completely reliable; timezones can break this value, and incorrectly configured news servers will make it almost useless. | |
subject | string - A slightly munged copy of the article's subject. The segment counter (xx/yy) usually found at the end, is replaced with (1/yy). You can use the yy to confirm all segments are present. | |
Body | None (placeholder) | |
Children | <groups>, <segments> |
<groups> . </groups> | |
---|---|
Description | Placeholder element for a list of groups that reference the file |
Attributes | None |
Body | None (placeholder) |
Children | <group> |
<group> . </group> | |
---|---|
Description | One <group> element represents a group, multiple may be used |
Attributes | None |
Body | string - The name of the group (e.g. alt.binaries.newzbin) |
Children | None |
<segments> . </segments> | |
---|---|
Description | Placeholder element for a list of segments that make up a file |
Attributes | None |
Body | None (placeholder) |
Children | <segment> |
<segment> . </segment> | ||
---|---|---|
Description | One part segment of a file | |
Attributes | bytes | int - Size of the article, in bytes, as a number, with no comma separation. |
number | int - Segment number of the article, gleaned by parsing (yy/zz) | |
Body | string - The Message-ID of this article, without the surrounding < and > (e.g. [email protected]) | |
Children | None |
Metadata Defined Types
The meta tag (as a child of the head tag), added in NZB 1.1, is designed to allow posters to include arbitrary data in any NZB file, which decoders might find useful. It's a very simple key-value system, where the key is the 'type' attribute.
In order to create some consistency, we define the following types; if you'd like one added, let us know so others will know of it's existence and may choose to use it. As per usual XML, these types are case sensitive so take care.
Nzb Drop V2 43 Inch
- title - a human-readable identifiable title for the contents of the NZB, ie the body of a metadata tag with the title attribute could be 'Ubuntu Linux 9.10 64bit Desktop CD'
- tag - An attribute, like h246 or SD (multiple tags allowed)
- category - A category as used by your indexing service (preferably one)
- password - if any password is required for the contents of the NZB, it can be specified in a password meta-tag. If there are multiple passwords, this tag could simply be specified more than once and they can all be tried. If it becomes a common requirement we may develop a way to associate a password tag (or indeed any meta tag) with a specific file block.
If you'd like to create your own private type which will never clash with any that we define, prefix it with X- as per HTTP. ie, X-Some-Private-Type
Filename extension | |
---|---|
Internet media type | application/x-nzb |
Developed by | NewzBin[2] |
Latest release | |
Type of format | Usenet extender |
Extended from | XML |
Open format? | yes |
Website | NZB file specification[3] |
Nzb Drop V2 43 Gen 4
NZB is an XML-based file format for retrieving posts from NNTP (Usenet) servers.[4] The format was conceived by the developers of the Newzbin.comUsenet Index.[5][6] NZB is effective when used with search-capable websites.[7] These websites create NZB files out of what is needed to be downloaded.[8] Using this concept, headers would not be downloaded hence the NZB method is quicker and more bandwidth-efficient than traditional methods.[9]
Each Usenet message has a unique identifier called the 'Message-ID'.[10] When a large file is posted to a Usenet newsgroup, it is usually divided into multiple messages (called segments or parts) each having its own Message-ID.[11] An NZB-capable Usenet client will read all needed Message-IDs from the NZB file, download them and decode the messages back into a binary file (usually using yEnc or Uuencode).[12]
File format example[edit]
The following is an example of an NZB 1.1 file.[13] Rogue amoeba soundsource 4 1 4.
See also[edit]
References[edit]
- ^'.nzb file extension :: all about the .nzb file type'. www.cryer.co.uk. Retrieved 2020-01-24.
- ^'NZB explained'. 2013-02-09. Archived from the original on 2013-02-09. Retrieved 2020-01-24.
- ^'NBDocs - NZBSpecification'. 2004-04-23. Archived from the original on 2004-04-23. Retrieved 2020-01-24.
- ^'NZB Files Explained in Plain English'. Retrieved 2020-01-24.
- ^'nzb 0.1 Released « nzb'. Retrieved 2020-01-24.
- ^'Power-Post-2000-A&A'. powerpost.free.fr. 2004-03-21. Retrieved 2020-01-24.
- ^'Tutorial: What is NZB? What are NZB files?'. Binaries4all Usenet Tutorials. Retrieved 2020-01-24.
- ^'What is an NZB File? (with picture)'. wiseGEEK. Retrieved 2020-01-24.
- ^'Select download folder when using NZB?'. NewsLeecher Forums. 2004-09-11. Retrieved 2020-01-24.
- ^'Handleiding: Wat zijn NZB-bestanden? Wat is NZB?'. binaries4all.nl. Retrieved 2020-01-24.
- ^'NBDocs - What Is An NZB File'. 2004-05-04. Archived from the original on 2004-05-04. Retrieved 2020-01-24.
- ^'nzb - Browse /nzb/0.1'. SourceForge.net. Retrieved 2020-01-24.
- ^'WWW::Newzbin - Interface to Newzbin.com's Usenet index'. metacpan.org. Retrieved 2020-01-24.
External links[edit]
- Usenet search engines with NZB support at Curlie
Retrieved from 'https://en.wikipedia.org/w/index.php?title=NZB&oldid=964484762'