Skip to content
DROID (Digital Record and Object Identification)
Java HTML XSLT PostScript Arc Batchfile Other
Branch: master
Clone or download

Latest commit

jcharlet Merge pull request #436 from digital-preservation/fix_ui
Fix filter button on windows on java8
Latest commit d3b0fde Mar 27, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
droid-binary
droid-build-tools
droid-command-line fix: iso prefix in CLI when expanding ISO archives Mar 27, 2020
droid-container
droid-core-interfaces Merge pull request #378 from digital-preservation/fix_skeleton_issue_371 Feb 11, 2020
droid-core Removed the 2 test files that are identified as TROJAN by virus scann… Feb 12, 2020
droid-export-interfaces
droid-export fix logging Jan 29, 2020
droid-help fix: copyright license on GUI help from 2009-2016 to 2009-2020 Feb 19, 2020
droid-parent Merge pull request #414 from digital-preservation/dependabot/maven/co… Mar 12, 2020
droid-report-interfaces Corrected email-id in the copyright header across all files Jan 20, 2020
droid-report fix logging Jan 29, 2020
droid-results remove: unused class Mar 26, 2020
droid-swing-ui Fix filter button on windows on java8 Mar 27, 2020
droid-tools fix logging Jan 29, 2020
.gitattributes Mark test files as binary to prevent line endings changes. Dec 13, 2016
.gitignore Mark test files as binary to prevent line endings changes. Dec 13, 2016
.travis.yml Remove unnecessary bionic build Nov 24, 2019
LICENSE Corrected email-id in the copyright header across all files Jan 20, 2020
README.md
Signature syntax.md Fix Signature syntax.md with link to sigtool description Nov 28, 2019
appveyor.yml Upd: travis and appveyor config to use jdk11 Oct 10, 2019
license.md
pom.xml

README.md

DROID (Digital Record Object Identification)

The latest binary file can be downloaded from The National Archives website.

Build Status Build status Maven Central

More information can be found on the DROID github pages here: http://digital-preservation.github.com/droid/

General Information

DROID is a software tool developed by The National Archives to perform automated batch identification of file formats. Developed by its Digital Preservation Department as part of its broader digital preservation activities, DROID is designed to meet the fundamental requirement of any digital repository to be able to identify the precise format of all stored digital objects, and to link that identification to a central registry of technical information about that format and its dependencies.

DROID uses internal signatures to identify and report the specific file format versions of digital files. These signatures are stored in an XML signature file, generated from information recorded in the PRONOM technical registry. New and updated signatures are regularly added to PRONOM, and DROID can be configured to automatically download updated signature files.

DROID is a platform-independent Java application. It can be invoked from two interfaces:

  • Java Swing GUI
  • Command line interface

DROID allows files and folders to be selected from a file system for identification. This file list can be saved at any point. After the identification process had been run, the results can be output in various report formats, including CSV.

DROID is made available under the New BSD License: https://raw.github.com/digital-preservation/droid/master/license.md

Building DROID

DROID can be built from source using Maven. The source code can be obtained from the Github repository at https://github.com/digital-preservation/droid

Once the code is cloned into a folder (e.g. droid), executing mvn clean install inside it will build the code. After a successful build, two archives are provided inside the droid-binary/target folder.

Linux / OSX / Windows users

Archive droid-binary-${VERSION}-bin-unix.zip

You will need JAVA 8 to 11 installed to run it.

Once unpacked, use the droid.sh or droid.bat script to run the application.

Windows users

Archive droid-binary-${VERSION}-bin-win32-with-jre.zip

For Windows users who might not be able to install JAVA, the provided bundle includes JAVA 11.

Once unpacked, use the droid.bat script to run the application.

Signatures

Since version 6.5, DROID adds some new capabilities to support developing and testing signatures.

Signature syntax provides details on the types of signatures and regular expression syntax supported by DROID.

sigtool

To aid work on signatures, we provide sigtool, packaged with DROID. sigtool is a simple command line application which can:

  • test binary or container signatures directly against files.
  • generate signature XML from binary or container signatures.
  • convert signatures between the original (binary) and the newer (container) syntax.
  • produce summaries of signature XML files, converting the XML back into signatures.
  • convert standard XML signature files into a simpler format, which uses the signatures directly.

More details are provided in Sigtool's user guide .

Simpler signature XML

Since version 6.5, DROID can compile signatures itself, without needing a full XML specification. Inside current signature files, the actual sequences to match are specified in various sub-elements and attributes of <ByteSequence> elements.

For example, the signature {10-1024} 01 02 03 04 05 [00:30] * 01 02 03 is represented in signature XML by:

<ByteSequence Reference="BOFoffset">
  <SubSequence SubSeqMinOffset="10" SubSeqMaxOffset="1024">
      <Sequence>01 02 03 04 05</Sequence>
      <RightFragment MaxOffset="0" MinOffset="0" Position="1">[00:30]</RightFragment>
  </SubSequence>
  <SubSequence>
      <Sequence>01 02 03</Sequence>
  </SubSequence>
</ByteSequence>

DROID can now put a signature directly inside a Sequence attribute on the <ByteSequence> element, with no further XML required. For example, the signature above can be simply written as:

<ByteSequence Reference="BOFoffset" Sequence="{10-1024} 01 02 03 04 05 [00:30] * 01 02 03" />

The full syntax can be used in either binary or container signature files.

Developer related guidance

Please check the wiki

You can’t perform that action at this time.