Skip to content
This repository has been archived by the owner on Oct 8, 2024. It is now read-only.
/ nfog Public archive

Scriptable Database-Driven NFO Generator for Movies and TV

License

Notifications You must be signed in to change notification settings

rlaphoenix/nfog

Repository files navigation

nfog

Important

This has been functionally replaced with https://nfog.vercel.app

This original version of nfog had upstream packages break that were quite critical, but even then, a vast majority of users struggled to grasp the CLI commands. And to be honest I can't blame anyone since really too many arguments were there.

The new Web App version is a lot nicer to use with a lot of automation built into it as well as an on-the-fly previewing system where you can see the variables available.

License Python Support Release GitHub issues

Scriptable Database-Driven NFO Generator for Movies and TV.

Installation

pip install --user nfog

Building

Dependencies

Installation

  1. git clone https://github.com/rlaphoenix/nfog
  2. cd nfog
  3. poetry config virtualenvs.in-project true (optional, but recommended)
  4. poetry install
  5. nfo -h

Creating Templates

We use Template's to define the structure and logic that creates your NFO file. Your Template file may create NFOs of any kind of encoding or style, including ASCII, ANSI, and such. You don't have to conform to any specifications of any kind, but are encouraged to if possible.

To create a Template file, you simply need to inherit the Template class in nfog.template, fill out the various abstract methods/properties, and create an nfo property that returns a final string.

Take a look at the Example Templates for pre-made examples for various NFO usage scenarios. You may modify these Templates in any way you like.

Note: While you have complete freedom with what Python code you run from within the template, this also means you should not immediately trust template file as they are after all still Python files.

Creating Artwork

Just like Templates, we use Artwork files to define the look and style of the surrounding NFO. You may also do introspection of the NFO output to merge style within the contents of the NFO as well.

To create an Artwork file, inherit the Artwork class in nfog.artwork, fill out any abstract methods and properties, and create the with_template function that returns the final string containing both the NFO output (from template argument) and the Artwork.

Take a look at the Example Artwork to see how these are used. However, you cannot re-use these, or make derivative works. Please see the Artwork License for more information.

Using Templates and Artwork

To use Templates and Artwork, calling nfo (or nfo generate) will ask you for various information, but one of them is a Template to use. The Templates it makes available to use are loaded from the user templates directory which can be found by typing nfo version.

To use an Artwork, specify the name of the Artwork file (case-sensitive) to -a/--artwork. Using an Artwork is completely optional.

For more information on using nfog, see the usage help by calling nfo --help.

License

Apache License, Version 2.0