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.
Scriptable Database-Driven NFO Generator for Movies and TV.
pip install --user nfog
git clone https://github.com/rlaphoenix/nfog
cd nfog
poetry config virtualenvs.in-project true
(optional, but recommended)poetry install
nfo -h
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.
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.
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
.