Key Features

• Unified Structure: Single, comprehensive format for all .nfo files
• Open Source: Licensed under The Unlicense - completely free to use
• Extensibility: Easily extendable for custom use cases (experimental features use x- prefix)
• Modularity: Separate XSD schema files for different content types
• Backward Compatibility: Built-in versioning strategy following Semantic Versioning 2.0.0
• Comprehensive Documentation: Full user guides, API references, and migration guides
• Multiple Format Support: Converters available for JSON and Protocol Buffers

Supported Media Types

The NFO Standard v2.0.0 supports comprehensive metadata for the following media types:

• Movies: Comprehensive metadata for films (movie.xsd)
• TV Shows: Detailed information for television series (tvshow.xsd)
• Music: Information for music tracks and albums (music.xsd)
• Audiobooks: Metadata for audiobooks (audiobook.xsd)
• Podcasts: Details for podcast episodes and series (podcast.xsd)
• Anime: Metadata tailored for anime series and movies (anime.xsd)
• Adult Content: Specific schema definitions for adult content (adult.xsd)
• Music Videos: Information for music video content (musicvideo.xsd)
• Generic Videos: General video content (video.xsd)

Each media type has its own dedicated XSD schema for validation, with common elements shared through modular schema files.

What's New in Version 2.0.0

Version 2.0.0 brings significant improvements and enhanced standards compliance:

• Enhanced Validation: All type names now use UpperCamelCase convention (e.g., RatingType instead of ratingType)
• ISO Standards Compliance: Country codes now use ISO 3166-1 alpha-2 format (e.g., "US" instead of "USA")
• Improved Content Rating Structure: Content ratings now use child elements for better extensibility
• Better Type Constraints: Rating values limited to 1 decimal place, improved validation patterns
• Testing Infrastructure: Comprehensive automated testing for all schemas and examples
• Developer Tools: Protocol Buffer support, migration scripts, and enhanced validation tools

Migration from v1 to v2

If you're upgrading from v1, key changes include:

• Update your schema location to https://xsd.nfostandard.com/v2/main.xsd
• Convert ContentRating elements to the new child element structure
• Update country codes to ISO 3166-1 alpha-2 format
• Update type references to use UpperCamelCase naming

Version 1 schemas remain available at their original URLs for backward compatibility during migration.

Validation Tools and Libraries

To ensure your NFO files conform to the standard, we provide multiple validation tools:

• Python Validator: Install with pip install nfo-validate
• JavaScript/Node.js Validator: Install with npm install @nfostandard/validator
• Direct XSD Validation: Use any XML validator with our schemas at https://xsd.nfostandard.com/v2/

Coming Soon - Platform Support

We are actively developing plugins for major media platforms:

• Plex: In Development
• Jellyfin: In Development
• Emby: In Development
• Kodi: Planned
• Sonarr: Planned
• Radarr: Planned

If you are a developer, we welcome contributions! Check our GitHub for plugin development guides and migration tools.

Online NFO Validator

Validate your NFO files directly in your browser using our online validator. Paste your XML content below to check if it conforms to the NFO Standard v2.0.0 schema:

Project Status

🎉 Version 2.0.0 Released! - The NFO Standard has released version 2.0.0 as of December 9, 2024, with major improvements and enhanced validation.

Long-Term Support: Version 2.0.0 includes backward compatibility with v1 schemas still available for migration purposes.

Example XML File

Here's an example of an NFO file for a movie, demonstrating the use of our schema:

<?xml version="1.0" encoding="UTF-8"?>
<root xmlns="NFOStandard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="NFOStandard https://xsd.nfostandard.com/v2/main.xsd">
  <media>

  <movie>
    <title>Inception</title>
    <originaltitle>Inception</originaltitle>
    <sorttitle>Inception</sorttitle>
    <alternatetitle>Origem</alternatetitle>
    <alternatetitle>Début</alternatetitle>
    <rating name="imdb" max="10" default="true" value="8.8" votes="200000"/>
    <userrating>9.0</userrating>
    <outline>A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a C.E.O.</outline>
    <plot>Dom Cobb is a skilled thief, the absolute best in the dangerous art of extraction: stealing valuable secrets from deep within the subconscious during the dream state when the mind is at its most vulnerable. Cobb's rare ability has made him a coveted player in this treacherous new world of corporate espionage, but it has also made him an international fugitive and cost him everything he has ever loved. Now Cobb is being offered a chance at redemption. One last job could give him his life back but only if he can accomplish the impossible, inception.</plot>
    <tagline>Your mind is the scene of the crime.</tagline>
    <runtime>148</runtime>
    <banner type="poster" width="300" height="450" url="http://example.com/poster1.jpg"/>
    <thumb type="thumbnail" width="150" height="150" url="http://example.com/thumb1.jpg"/>
    <fanart type="thumbnail" width="150" height="150" url="http://example.com/fanart1.jpg"/>
    <fanart type="thumbnail" width="150" height="150" url="http://example.com/fanart2.jpg"/>    
    <contentrating country="US" board="MPAA">
      <rating>PG-13</rating>
      <image>mpaa_pg13.png</image>
    </contentrating>
    <uniqueid type="imdb" default="true">tt1375666</uniqueid>
    <uniqueid type="tmdb">12345</uniqueid>
    <genre>Action</genre>
    <genre>Sci-Fi</genre>
    <tag>Heist</tag>
    <tag>Dream</tag>
    <setname>Inception Series</setname>
    <setoverview>Movies about dream extraction.</setoverview>
    <country>US</country>
    <productioncompany>Warner Bros.</productioncompany>
    <keyword>dream</keyword>
    <keyword>heist</keyword>
    <releasedate>2010-07-16</releasedate>
    <award>Academy Award for Best Cinematography</award>
    <subtitlelanguage>English</subtitlelanguage>
    <soundtrack>Inception OST</soundtrack>
    <parentalguide>Some material may be inappropriate for children under 13.</parentalguide>
    <actor>
      <name>Leonardo DiCaprio</name>
      <role>Dom Cobb</role>
      <order>1</order>
      <thumb>leo.jpg</thumb>
      <bio>Leonardo Wilhelm DiCaprio is an American actor and film producer.</bio>
      <url>https://www.imdb.com/name/nm0000138/</url>
    </actor>
    <actor>
      <name>Joseph Gordon-Levitt</name>
      <role>Arthur</role>
      <order>2</order>
      <thumb>joseph.jpg</thumb>
      <bio>Joseph Leonard Gordon-Levitt is an American actor and filmmaker.</bio>
      <url>https://www.imdb.com/name/nm0330687/</url>
    </actor>
    <director>
      <name>Christopher Nolan</name>
      <thumb>nolan.jpg</thumb>
      <bio>Christopher Edward Nolan is a British-American film director, screenwriter, and producer.</bio>
      <url>https://www.imdb.com/name/nm0634240/</url>
    </director>
    <writer>
      <name>Christopher Nolan</name>
      <thumb>nolan.jpg</thumb>
      <bio>Christopher Edward Nolan is a British-American film director, screenwriter, and producer.</bio>
      <url>https://www.imdb.com/name/nm0634240/</url>
    </writer>
  </movie>
  </media>
  <library>
    <appID>YourMediaServer</appID>
    <libraryid>movies</libraryid>
    <dateAdded>2024-01-15T00:00:00</dateAdded>
  </library>
</root>
            

Getting Started

Ready to start using the NFO Standard? Here are some quick links to help you:

• Documentation: Check out our comprehensive documentation
• Examples: Browse example NFO files for all media types
• Schemas: Access our XSD schemas for validation
• Tools: Download validation and conversion tools