NMJToolbox2 User Guide V1.5.1.

NMJToolbox2 User Guide

By Chris Nicholson
Copyright© 2011-2013

1
 NMJToolbox2 User Guide V1.5.1.0

Table of Contents
Before you start – preparation ............................................................................................................. 6
‘Installing’ ............................................................................................................................................. 7
The Application Screen ......................................................................................................................... 8
The Menu and Toolbar ......................................................................................................................... 8
The Menu .......................................................................................................................................... 8
File Menu ...................................................................................................................................... 8
Open... ...................................................................................................................................... 8
Save ........................................................................................................................................... 8
Settings Menu ............................................................................................................................... 8
Paths ......................................................................................................................................... 8
Database Location ................................................................................................................. 9
Media Location ..................................................................................................................... 9
Multishare ............................................................................................................................. 9
Auto Save ................................................................................................................................ 10
Do Not Process Article ............................................................................................................ 10
Round Up IMDB Rating ........................................................................................................... 10
Check for Updates at Startup .................................................................................................. 10
Help Menu .................................................................................................................................. 11
NMJToolbox Website .............................................................................................................. 11
NMJ Forum Thread ................................................................................................................. 11
Help ......................................................................................................................................... 11
About ...................................................................................................................................... 11
The Toolbar ..................................................................................................................................... 12
Open ...................................................................................................................................... 12
Save ...................................................................................................................................... 12
Expand Tree ........................................................................................................................... 12
Collapse Tree ......................................................................................................................... 12
Refresh Tree View ................................................................................................................. 12
Query TheMovieDB ............................................................................................................... 12
Query TheTVDB ..................................................................................................................... 12
Set the Language of Internet Queries ......................................................................................... 12
Update Media Info From File ................................................................................................. 12
Add New Movie ..................................................................................................................... 12
Add New TV Series ................................................................................................................ 12

2
 NMJToolbox2 User Guide V1.5.1.0

Add New Album .................................................................................................................... 13

Edit Cast ................................................................................................................................ 13
Edit Keywords ........................................................................................................................ 13
Edit Genres ........................................................................................................................... 13
Edit External Subtitles ........................................................................................................... 13
Produce Report ..................................................................................................................... 13
Scan for Files Not in DB ......................................................................................................... 13
Scan for new Media and Add to the DB ................................................................................ 13
Scan for new FILMS and Add to the DB ................................................................................. 13
Scan for new MUSIC and Add to the DB ................................................................................ 13
The Image Panel.............................................................................................................................. 13
The TreeView .................................................................................................................................. 13
The Details Tabs .............................................................................................................................. 14
File Naming ......................................................................................................................................... 15
Media files ...................................................................................................................................... 15
Movies ........................................................................................................................................ 15
TV Episodes ................................................................................................................................. 16
Multiple TV Episodes in One Video File ....................................................................................... 16
DVD and BluRay Folder Structures .................................................................................................. 16
Setting Words to Ignore’ ................................................................................................................. 16
Movies ................................................................................................................................................ 17
Adding a New Movie ....................................................................................................................... 17
Adding Manually ......................................................................................................................... 17
Scanning ...................................................................................................................................... 17
Creating a multiple file movie entry ................................................................................................ 18
A completely new movie ............................................................................................................. 18
An existing movie where both video parts are already in the database ..................................... 18
Deleting a Movie ............................................................................................................................. 19
Changing Movie Details ................................................................................................................. 19
Changing the Movie Title & Search Title ..................................................................................... 19
Updating Movie Details Automatically............................................................................................ 20
Updating Movie Details from TheMovieDB ................................................................................ 20
Updating the MediaInfo of the Media File for a Movie............................................................... 20
TV Shows............................................................................................................................................. 21
Adding a New TV Show ................................................................................................................... 21
Manually adding a new Series..................................................................................................... 21
Adding a New Series Using the Scanner ...................................................................................... 22

3
 NMJToolbox2 User Guide V1.5.1.0

Adding a Season or Episode to an Existing TV Show ....................................................................... 22

Deleting a TV Series/Season/Episode ............................................................................................. 22
Changing TV Show/Season/Episode Details ................................................................................... 22
Updating TV Title Details Automatically.......................................................................................... 22
Moving a TV Season or Episode to a different TV Show.................................................................. 23
Moving a TV Season or Episode to a New TV Show ........................................................................ 23
Moving a Movie to a TV Show ........................................................................................................ 23
Music .................................................................................................................................................. 24
Overview ............................................................................................. Error! Bookmark not defined.
Adding a New Album ...................................................................................................................... 24
Adding a Track to an Existing Album ............................................................................................... 25
Deleting a Track or Album ............................................................................................................... 25
Changing a Track or Album Details ................................................................................................. 26
Updating Audio Track Details Automatically ................................................................................... 26
Moving a Track to a Different Album .............................................................................................. 26
Utilities Menu ..................................................................................................................................... 28
Fix Video Count & Type ................................................................................................................... 31
Fix TV Errors .................................................................................................................................... 31
Fix ‘\’ in Paths.................................................................................................................................. 32
Bulk Get IMDB Ratings .................................................................................................................... 32
Settings -> Use IMDB for Ratings ................................................................................................ 32
Settings -> Round Up IMDB Ratings ............................................................................................ 32
Delete Orphaned Records ............................................................................................................... 32
Rebuild Index .................................................................................................................................. 33
Clean Up Image Folders .................................................................................................................. 33
Fix Subs (Android) ........................................................................................................................... 34
Edit Indices ...................................................................................................................................... 34
Remove Backups ............................................................................................................................. 34
Trim Cast Entries ............................................................................................................................. 34
Rebuild SCAN_DIRS Ids ................................................................................................................... 34
Bulk Actions Menu .............................................................................................................................. 35
Update All Audio MediaInfo ........................................................................................................... 35
Scan and Add New Media ............................................................................................................... 35
Fill in Missing Video Images ............................................................................................................ 35
Fill in Missing Audio Images ............................................................................................................ 35
Remove Deleted File Entries ........................................................................................................... 36
Optimise Images ............................................................................................................................. 36
Export .nfo files ............................................................................................................................... 36

4
 NMJToolbox2 User Guide V1.5.1.0

FAQ/Troubleshooting ......................................................................................................................... 37
Setup ............................................................................................................................................... 37
Q. Why do I have to set paths? ................................................................................................... 37
Q. What do I put in the WINDOWS_PATH section of the Paths->Settings screen? ..................... 37
Q. When I go into the Paths screen in NMJToolbox2 there is nothing entered in the PCH_PATH
column, so what do I put in the WINDOWS_PATH column. ........................................................ 37
Q. Does NMJToolbox2 support UNC paths (eg \\<servername>\<folder> etc.)? ........................ 37
Q. What are the dropdown combo boxes for in the Paths->Settings window. ........................... 37
Q. I select a different language setting in Settings->UI Language but the application is still in
English.... ..................................................................................................................................... 37
Editing ............................................................................................................................................. 38
Q. How do I change the artwork on a movie/tv show/tv season? .............................................. 38
Q. That's fine but what if I don't like those images or want to use my own?.............................. 38
Q. An entry has images but I don't want any image, how can I remove the image? ................... 38
Q. I have a movie/TV Show that has the details for another (incorrect) film/TV Show. How to I
get the correct details? ............................................................................................................... 38
Q. The Title is wrong, how do I change it? .................................................................................. 38
Q. I want to edit the 'Search Title - How do I do that? ................................................................ 39
Q. How do I change the Cast/Keywords/Genre(s) of an entry? .................................................. 39
Scanner ........................................................................................................................................... 39
Q. How do I stop the scanner from scanning a particular share or folder? ................................. 39
Q. Using the scanner the progress window pops up and closes without anything being added. 40
Q. The scanner adds my files but some entries are wrong, why? ............................................... 40
Q. The scanner added one or more TV episode into the Movies section... ................................. 40
Q. I have a file that is multiple TV episodes in one, how do these get added as separate episodes
in the NMJ? ................................................................................................................................. 40
Q. I have some 3D files but they are not marked as 3D automatically when added with NMJT2
either manually adding or via the scanner. ................................................................................. 40
Common NMJ / NMJToolbox2 Questions & issues ......................................................................... 41
Q. In NMJToolbox2 why are some of the names in the Treeview greyed out? ........................... 41
Q. What do the different icons mean in the Treeview? .............................................................. 41
Q. I go into a TV season and see one or more Episodes called 'Unknown' and none of them play.
.................................................................................................................................................... 41
Q. There are entries in the NMJ, they play OK but the artwork is not showing. However, the
artwork shows when viewing the entry in NMJToolbox2. .......................................................... 41
Q. I see an entry in NMJToolbox2 but I can't find it in the NMJ, why is this? .............................. 41
Q. When I view details on an entry in the NMJ the wallpaper/Fanart is 'zoomed' in. ................ 41
Q. Using the 'Fill in missing Video Images' option does not seem to have filled in all of the
missing images. ........................................................................................................................... 42

5
 NMJToolbox2 User Guide V1.5.1.0

Before you start – preparation

Like anything, preparation makes everything run smoother and the results better. To prepare for
the NMJ and using NMJToolbox try to ensure that your media files are named sensibly.
For Movies it is recommended that you name a movie <Movie Name> (<movie year>).XXX
Eg Gladiator (2000).mkv

For TV shows use <Show Name> SXXEXX <Episode Title>.XXX

Eg Fringe S01E01 Pilot.mkv

If you have multiple episodes (eg episodes 1 2 & 3 on a disc rip) then it would be:
Fringe S01E01E02E03.iso

DVD and BluRay folder rips are the same except you should name the folder that contains the
VIDEO_TS or the BDMV folder as above Eg:

Or

6
 NMJToolbox2 User Guide V1.5.1.0

‘Installing’
There is no installation for NMJToolbox2. It will run from wherever you place the exe file. However
there are a few things you should be aware of:
1. You always need the recommended MediaInfo.dll, System.Data.SQLite.dll and
Infralution.Localization.dll files in the same folder as the NMJToolbox2.exe.
2. If you are using Windows7 it is recommended NOT to place the NMJToolbox2 program in the
Program Files folder of your system. This is because Windows7 does not allow programs by
default to write to this location. NMJToolbox2 writes occasional files and it’s settings to the
same folder that it is run from. If it cannot write to this location you may get errors reported
and your settings will not get saved.
3. If you are using a UI (User Interface) language other than English you also need one of the
language packs. These are dll files contained in a folder for your chosen language. You
should extract the language_xx.zip to your NMJToolbox2 folder as well.

A folder with NMJToolbox2 installed should look like the following image (this installation has the
French language enabled). Note that the NMJToolbox2.parameters file is created by NMJToolbox2
after the first time you run the program and exit. It simply stores your settings and preferences for
the next time you open the program.

7
 NMJToolbox2 User Guide V1.5.1.0

The Application Screen

The main application screen for NMJToolbox2 is where most of the work can be done. There are 4
main sections that change according to what you are currently viewing.

The Menu and Toolbar

The Menu
File Menu

Open...
Allows you to browse to your nmj_database folder and select the media.db file that you wish to edit.

Save
Selecting this will save the current details that are in the details panel for the item that you currently
have selected in the TreeView.

Settings Menu

Paths
This is probably the most important setting in the application. Get this wrong and you won’t have
much success adding new files or artwork. Selecting this option brings up the following screen:

In the Grid View (where the three columns, ID, PCH_PATH & WINDOWS_PATH are), you may or may
not have an entry in the PCH_PATH column. If you do have any entries you will need to complete
the WINDOWS_PATH entry adjacent to it.

The value that needs entering is the path that Windows needs to use to get to the same location on
your network that the PCH_PATH is specifying. This value can be a UNC path (this is a path that
starts \\<server>\<folder>\<folder> etc) OR (recommended) a mapped windows drive letter (like it is
on the example above).

To edit the Windows path, click in the cell you want to edit to select it and then click in it again. You
should get a cursor appear in the cell allowing you to edit it.

8
 NMJToolbox2 User Guide V1.5.1.0

Q. What if there are no entries in the PCH_PATH field?

This is normal, it just means that you have media and the database on the same drive (with no
additional specific folders selected) and you do not need to set anything in the WINDOWS_PATH
field.

The bottom two dropdown boxes tell NMJToolbox2 a bit about your setup to help it to decide what
it needs to process in paths when you add images and media files....

Database Location
If you have the media.db/nmj_database folder on your internal PCH drive, set this to ‘PCH Internal
Drive’ – otherwise set it to ‘Network Share’.

Media Location
If the database you are opening for editing is for media files that are on your internal PCH drive, set
this to ‘PCH Internal Drive’ – otherwise set it to ‘Network Share’.

Multishare

At the time of writing, NMJToolbox2 is the only editor that can administer databases that have
shares/paths from multiple sources. This is called Multishare. The NMJ does not have any facility to
add these shares, it can only add one share location (but can add multiple folders from that single
share). However, the NMJ can use shares from multiple locations.

Note: If you wish to use multiple network shares, SMB is recommended over NFS as the PCH will auto
mount SMB shares whereas NFS/NFS-TCP shares will not auto-mount. If an NFS share is added, you
will have to access the NFS share in file browser mode to force the NMJ to mount it before you enter
the NMJ. If you do not do this the file entries in the database that reside on the NFS share will not
play from the NMJ interface. SMB is automatically mounted dynamically so you will not have this
issue.

To set up multishare you must start with a database with at least one ‘path’ added. Once you have
this enter the Settings->Paths option and click the ‘Multishare’ button. You will be presented with
the following screen:-

 Ensure that all of the shares that you wish to add to the database are set up as defined
network shares on the PCH that you are going to query.
 Enter the IP address or network name of the PCH that the database is for and click the ‘Get
Shares’ button.

9
 NMJToolbox2 User Guide V1.5.1.0

 In the datagrid below will be all of the shares that are set up on the PCH being queried.
 Place a check in the ‘Add’ column next to all of the shares that you wish to add.
 Click OK

You will be returned to the Paths screen and your new ‘shares’ will have been added to the list. You
should now set the WINDOWS_PATH for these new shares. Once complete click OK.

You may now add, delete, scan etc as you would any other share, your new shares will be valid for
the database.

Note: Once new shares have been added, the NMJ scanner will also recognise the new shares as it
would any standard share.

Auto Save
Selecting this will put a tick by the side of the option. When details in the detail panel on the right
hand side of the application are changed the save button requires selecting before moving to
another entry in the tree view. If the Auto Save option is ticked, NMJToolbox will automatically save
your changes when you move from one entry (movie, tv or music) to another.

Do Not Process Article

There are two titles fields for movies; The movie title in the tree view and the field in the details
panel title ‘search title’. The title in the treeview is what you see in the NMJ on your popcorn hour.
The ‘Search Title’ is what is used to index the movie in the database and is never actually displayed
in the NMJ. It indicates which section in the category view in the NMJ the film will appear in.
Example: ‘The Bourne Identity’
With the ‘Do Not Process Article’ option ticked, the ‘Search Title’ would be copied untouched and
NMJToolbox would add/index the title under ‘T’.
With the ‘Do Not Process Article’ option not ticked, the ‘Search Title’ would be amended to move
the first word, if it is an ‘article’ to the end of the ‘Search Title’ field. This would cause NMJToolbox
to change the ‘Search Title’ field to ‘Bourne Identity, The’ and would add/index the title under ‘B’.
Valid articles coded for (that would be moved from the beginning of a title) are:

The, A, An, Una, Un, El, Das, Der, Ein, Die, La, Le, Les, Une.

Round Up IMDB Rating

By default NMJToolbox2 gets movie ratings from TheMovieDB. However, some users requested a
facility to get the movie ratings from IMDB instead due to the ratings being more representative
(more user votes) than TheMovieDB.
There is a facility on the NMJToolbox2 titles tab to mass update all movie entries currently in your
database with the Rating from IMDB. However, on the IMDB the ratings are out of 10 to one
decimal place but the NMJ shows only stars out of 5. The NMJ will always round the figure to
convert into it’s 5 star rating system. Selecting this option in NMJToolbox rounds the IMDB rating to
the nearest whole figure to generate a more accurate star rating representation in the NMJ.

Check for Updates at Startup

When this option is selected each time NMJToolbox is opened and has an internet connection it will
check if there is a more up to date version of the application available.
If an updated version is found, you will be asked if you wish to download it. If you select ‘Yes’ the
update will be downloaded, extracted and installed automatically. NMJToolbox2 will restart itself to
launch the new version.

10
 NMJToolbox2 User Guide V1.5.1.0

Help Menu

NMJToolbox Website
This takes you directly to the NMJToolbox homepage where you can post comments and download
the latest version of the application and DLL files.

NMJ Forum Thread

Selecting this will take you directly to the official NMJToolbox2 forum thread on the Networked
Media Tank forum. Use this thread to post comments on the application or ask for help using the
application.

Help
Not implemented at the moment.

About
Displays the initial splash screen shown when the application first starts up.

11
 NMJToolbox2 User Guide V1.5.1.0

The Toolbar

Whilst navigating NMJToolbox, some of the buttons/options on the toolbar will be made unavailable
depending on which tab is currently selected and which (if any) type of node in the treeview is
selected.

Descriptions from left to right

Open
Opens a media.db file

Save
Saves any changes made to the details of the currently selected item in the treeview

Expand Tree
Expands all nodes on the tree view

Collapse Tree
Closes all nodes on the tree view.

Refresh Tree View

Rebuilds the tree view by re-loading the information directly from the database

Query TheMovieDB
Gets movie information via the internet from TheMovieDB website for the movie that is currently
selected in the tree view.

Query TheTVDB
Gets TV series & episode information via the internet from TheTVDB website for the TV Series that is
currently selected in the tree view.

Set the Language of Internet Queries

There are numerous language options in this dropdown list. Whichever is selected is used in
TheMovieDB/TheTVDB queries to indicate which language any results should be returned in.
Eg. Set the Language to fr-FR and the TV/Movie info will be returned in French, set it to it-IT and the
results returned will be in Italian.

Update Media Info From File

Selecting this when an entry is selected in the tree view and that entry has a file associated with it
will cause NMJToolbox2 to use MediaInfo to get the file details such as codec, runtime etc and
update the DB with the information.

Add New Movie

This allows you to add a completely new movie entry into the NMJ Database.

Add New TV Series

This allows you to add a completely new TV series entry into the NMJ Database.

Note: at least one episode (in one season) must be added.

12
 NMJToolbox2 User Guide V1.5.1.0

Add New Album

This allows you to add a completely new music album entry into the NMJ Database.

Edit Cast
Allows you to edit the cast on the selected movie, TV show/series/episode

Edit Keywords
Allows you to edit the keywords on the selected movie, TV show/series/episode

Edit Genres
Allows you to edit the genres on the selected movie, TV show/series/episode or Music Album

Edit External Subtitles

Allows you to add and remove references to external subtitle files for a movie or TV episode.

Produce Report
Creates a report (allowing the user to select the included data) from the database of the tree view
currently being viewed.

Scan for Files Not in DB

Scans your defined paths for files and reports any that are not already found in the DB.

Scan for new Media and Add to the DB

Scans the defined paths and adds any new video and music media found.

Scan for new FILMS and Add to the DB

Scans the defined paths and adds any new video media found.

Scan for new MUSIC and Add to the DB

Scans the defined paths and adds any new audio (mp3, FLAC & Ogg) media found.

The Image Panel

The Image panel will show the artwork (if any) for the selected Movie, TV show or Music album.
From this panel you can also change/update the artwork by using the button on it when enabled to
grab from the Internet. Alternatively you can drag & drop your own artwork onto the place holders.

The TreeView
This shows different views depending on the tab selected. Eg. When the movies tab is selected the
tree will show Movie->Movie Files. When TV is selected it shows Series->Season->Episode and for
music it shows Album->Tracks.

Selecting a node on an entry in the treeview will change the details that are shown in the details
panel on the right and images in the image panel to the left.

Each entry in the treeview has it’s own context menu available. Right click the entry to see the
available options.

13
 NMJToolbox2 User Guide V1.5.1.0

The Details Tabs

There are a number of tabs on the panel on the right of the application. The tab selected dictates
which toolbar buttons may become active, which image placeholders (if any) are relevant and what
data is used to populate the centre treeview.

The tabs allow the user to select which distinct section of the NMJDatabase is to be shown/edited.

Most information shown on the tab panel can be edited directly. Any changes required to be made
to the database will be completed automatically. However, some fields may not auto save in which
case you should click the ‘Save’ button on the toolbar after making changes.

If you make changes to the Details Panel and then change your selection in the treeview,
NMJToolbox2 will check if the record(s) should be saved before continuing and if so you will be
asked if you wish to save your changes.

14
 NMJToolbox2 User Guide V1.5.1.0

File Naming
For NMJToolbox2 to work at its best the files/folders it works with should be named well. The
following formats are recommended:

Media files
Movies

Movies should be named with the following format:

<film name> (<year>) <optional 3D tag>.ext

Eg: Avatar (2009).mkv

Periods and underscores between words are acceptable and will be stripped automatically for
internet querying, anything else (group tags, format, source etc) such as 'BluRay' are not
automatically stripped and may cause the query to fail. To handle this you can add text to the list of
words to strip before a query. See the ‘Setting Words to Ignore’ section.

The year in a filename is optional but will aid better detection especially if there are multiple movies
of the same name. If specifying a year you should put it in parenthesis to indicate to NMJToolbox2
that the number is a year and not part of the film name. The year may be contained in brackets [] or
parentheses (). Eg:

2012 (2009).mkv or 2012 [2009].mkv

If there are multiple movies of the same title made in the same year (eg Alice in Wonderland (2010))
then NMJToolbox2 will choose the film that has the highest rank in the search results from
TheMovieDB.

The <optional 3D tag> part can be included to indicate that the file is a 3D file and NMJToolbox2 will
mark as 3D automatically. Valid 3D tags are .3DSBS and .3DTAB.

Eg: Avatar (2009).3DSBS.mkv or Avatar (2009).3DTAB.mkv

Multiple file disc numbers can also be added. These must be in brackets [] and start with either CD,
PART, DISC or DISK.

As of release 1.5.1.0 further automatic parsing has been added. Any word or set of words contained
in brackets [] will be automatically stripped.

Examples:

Clash of the Titans (2010) [BluRay] [disc1].3DSBS.mkv

Clash of the Titans [2010] [BluRay] [disc2].3DSBS.mkv

 Clash of the Titans would be taken as the movie name

 2010 would be tken as the film year
 [BluRay] would be stripped and ignored.

15
 NMJToolbox2 User Guide V1.5.1.0

 [disc1] & [disc2] would return 1 & 2 respectively indicating the video part number of the
movie name and would add to any existing movie of the same title and year already in the
database.
 .3DSBS would cause the 3D flad to be automatically set in the database.


TV Episodes

For the TV episode to be detected as a TV file and not a movie is must have an indication in its
filename of the season and episode number. The following are the two ways that NMJToolbox2 can
detect these details automatically. The first way is preferable to the second:

Naming style 1

<series name> S9999E9999 <optional episode name>.EXT

Where S9999 is the season number and E9999 is the episode number. The S and E are required (not
case sensitive). The number after them may be up to 4 digits and may or may not have leading
zeroes.

Eg: Game of Thrones S01E03 Some Episode Name.mkv

Naming style 2
<series name> 9999X9999 <optional episode name>.EXT

Where first 9999 is the season number and the second 9999 after the ‘x’ (not case sensitive) is the
episode number. The number may be up to 4 digits and may or may not have leading zeroes. EG:

Game of Thrones 01x03 Some Episode Name.mkv

Multiple TV Episodes in One Video File

Note: NMJToolbox2 only processes multiple episodes in one video file when using naming style 1
(above).

An example filename detailing episodes 1-3 of Game of Thrones, season 2 would be formatted like
so:

Game of Thrones S02E01E02E03 Some Episode Name.mkv

DVD and BluRay Folder Structures

Folder structures are indicated by having folders named BDMV (BluRay) or VIDEO_TS (DVD) in their
structure. The naming of these structures is slightly different to files in that they need the folder
containing the BDMV or VIDEO_TS folders to be named correctly as in the previous section.

Setting Words to Ignore’

You set these in Settings->'Ignore Words in Filenames...'

16
 NMJToolbox2 User Guide V1.5.1.0

Enter the word to ignore in the box and click ‘Add’. The word is not case sensitive so adding ‘bluray’
would strip ‘BluRay’, BlUrAy’, ‘BLURAY’ etc.

When words are stripped NMJToolbox2 looks for empty parenthesis () and brackets [] and removes
them automatically so there is no need to add these to ‘Ignore Words’.

Movies
Adding a New Movie

Adding a new movie is simple. The video file that you select will be queried by NMJToolbox using
MediaInfo and will automatically add the file data such as resolution, codec, runtime etc to the
database. Also, when adding NMJToolbox2 will ask you what the title of the movie is (it defaults to
the file name). It will then search TheMovieDB for a matching movie and if found, adds the movie
data to the database as well. If multiple movie matches are found you will be asked to choose the
correct movie from a list of matches.

Adding Manually

1. Click the Add Movie on the toolbar

2. Use the open file dialog to browse to the media file that you want to add, select it and click
OK.
3. You will be prompted with the filename/movie name to query the MovieDB with. At this
point you can change the title. Alternatively you can add the IMDB ttID to point the query
to a specific movie entry..
4. Click OK.
5. If more than one match is found you will be presented with a dropdown list of results to
choose from. Select the required movie from the list then click OK.
6. The movie will be added, all media info queried and added and movie details and default
cover art will be added (if found on the movie DB).

Scanning

1. Click either the Scan for new media , Scan for new VIDEOS toolbar button or use the
Actions->Scan Specific Folder menu option (or F9).

17
 NMJToolbox2 User Guide V1.5.1.0

2. If Scan specific folder option is used you will be prompted to select the folder to scan (allows
you to scan only a part of your media store rather than the whole set of paths that the DB
knows about).
3. A progress window will open where NMJToolbox2 will scan all of your paths looking for
media that is not already in the database and add each entry it finds.

Creating a multiple file movie entry

A completely new movie

If you have a movie that has more than one media file for the complete movie do the following: -

Manually Adding
1. Add the first video file as you would a normal movie.
2. Right click the movie entry and select ‘Add file to this movie’ from the context menu.
3. Browse to ‘video file 2’ of the same movie. Select it and click OK.
4. If you have more files to add, repeat steps 2 & 3.

Scanning
Scanning will add multiple video files to one movie as long as a few file naming conditions are
adhered to:

1. The file name must be parsed by NMJToolbox2 to the same movie on a TMDB search. To
ensure this make the name and film year (if any) the same on all files for the same movie.
2. There must be a part in the filename that indicates the part number in (square) brackets [].
Within these brackets must be one of the following words (any case); CD, PART, DISC, DISK
followed by any characters then a single digit number.

Example:

A Nightmare on Elm Street [1984][SET A Nightmare on Elm Street-1] [Part 1][HDDVD]BLU-RAY –

UNCUT.avi
A Nightmare on Elm Street [1984][SET A Nightmare on Elm Street-1][HDDVD]BLU-RAY - UNCUT [cd
2].avi

The above would both conform to the filename rules and be detected as the same movie in 2 parts.
[SET A Nightmare on Elm Street-1] and [HDDVD] are automatically ignored as they are contained in
brackets and they do not hold a year or have text in them that starts with PART, CD, DISC or DISK.

Note: As of release 1.5.1.0, anything in brackets [] in a filename that is not parsed to a film date (4
digit year) or a film part number will be automatically stripped/ignored when querying the Movie DB.

An existing movie where both video parts are already in the database

If a previous scan has already added both media files to the database but they are added as separate
movies do the following:-

1. Expand the movie that is in the database for video file #2.

18
 NMJToolbox2 User Guide V1.5.1.0

2. Drag the video part on the treeview onto the movie entry for the movie containing the video
file #1.
3. The video file #2 will be added to movie #1 and movie #2 will be removed.

Example:

Result:

If you find that the video files are in the wrong order (eg part 2 is before part 1) you can reorder
them by right clicking one of the video entries or highlighting one to move and pressing <CTRL> +
Arrow Up/Down.

Deleting a Movie

To delete a movie do one of the following:

 Right click the movie node and select ‘Delete Complete Movie’
 Hit the delete key (this way will ask you to confirm if you really want to delete the movie).
 On the Actions menu select ‘Delete Entry’

Note, by default deleting an entry does not remove your media file. It only removes the database
entry. If you want NMJToolbox2 to remove the media file as well (not recommended) you can turn
the facility on by selecting Settings->System->Delete Media Files When Removing an Entry.

Changing Movie Details

Select the movie that you want to edit in the treeview. Selecting the movie node will show the film
details such as certificate, synopsis, cast etc. Selecting the video file node will down the media info
for the file such as resolution, codec, subtitles etc.

You can change any of the details to what you want. If the data needs to be a specific format (such
as rating should be a number) and the data you enter is invalid, NMJToolbox2 will not allow that
change.

Once you have edited your data click the Save toolbar button.

Changing the Movie Title & Search Title

To Change the movie title (the name in the treeview), select the node to change then either click on
the node a second time or press F2.

19
 NMJToolbox2 User Guide V1.5.1.0

You can directly change the search title, it is initially formatted automatically by NMJToolbox when
adding or changing the movie title in the treeview. If you edit the search title, when you move from
the search title text box (or hitting Enter whilst in it) NMJToolbox2 will save the changes and re-index
the movie.

You can specify if the article (The, An, A etc) are placed at the end of the Search Title (default) or not.

If you want the Search Title to be the same as the movie title in the tree you can turn off article
processing on the Settings->Do Not Process Title Article menu option.

Note: The ‘Search Title’ determines the Character that the movie is indexed under in ‘Category View’
mode in the NMJ.

Updating Movie Details Automatically

There are two sets of details that can be updated automatically, the movie details and the media
(video file) details.

Updating Movie Details from TheMovieDB

NMJToolbox2 can get details for a movie from any of the following 3 pieces of information:

 The Content ID (the ID of the movie on TheMovieDB.

 The ‘tt’ ID (the ID of the movie from IMDB.
 The Film Title.

The pieces of information are used in preference in the order above. So, if you want to search on
‘Title’, ensure that the IMDB tt ID and Content ID boxes are both blank.

1. Highlight the movie node that you wish to get the details for.
2. Ensure one of the relevant fields specified above is completed.
3. Click the ‘Update from TheMovieDB’ button on the toolbar.

Updating the MediaInfo of the Media File for a Movie.

To update media info (Codec, Resolution, Format etc) :

1. Select the video file entry.
2. The MediaInfo Update button should be enabled, click it.

20
 NMJToolbox2 User Guide V1.5.1.0

TV Shows
TV shows are handled a little differently in the NMJ. For any Episode in a TV series it must have 3
levels attached to it:

A series (1) must have 1 or more Seasons (2).

A season (2) must have one or more Episodes (3).

Only Series and Season records can have artwork attached to them. The season name is
automatically generated from the Series record name plus the word ‘Season’ plus the season
number. You can override the name on a season by season basis but it is unlikely that you need to.

The word ‘Season’ can be changed so that NMJToolbox2 will use a word you define in your language
instead. You can set this replacement word using the Settings->’Word For Season’ menu option.

Adding a New TV Show

As with movies, TV shows can be added in a couple of ways. The main rule to know is how
NMJToolbox2 detects that a video file is a TV show. For this to work it is recommended the
following naming convention is used.

Manually adding a new Series

To manually add a new series you need to add at least one episode record. You can add more than
one episode at once but all of the episodes must be from the same series and season number.

1. Click the ‘Add New TV Entry’ toolbar button.

2. Browse & select the episode file(s) that you want to add.
3. If your files are named as recommended (naming style 1 or 2) then there is nothing more to
do, NMJToolbox2 will do everything for you automatically.
4. If your files are named in such a way that NMJToolbox2 cannot recognise the season and
episode number from the filename then you will be prompted to specify the season and
episode number to add. The name of the file will be used as the series name.

21
 NMJToolbox2 User Guide V1.5.1.0

Adding a New Series Using the Scanner

For the scanner to work at it’s best it is recommended to use ‘Naming style 1’ in the ‘Adding A New
TV Series’ section above.

1. Click either the Scan for new media or Scan for new VIDEOS toolbar button.
2. A progress window will open where NMJToolbox2 will scan all of your paths looking for
media that is not already in the database and add each entry it finds.
3. It will add episodes to existing series or seasons where it can find an existing match
otherwise it will add new series and seasons as required.

Adding a Season or Episode to an Existing TV Show

1. Right click an existing series or season node in the treeview select Add Episode(s) or select
the required series/season and select ‘Add to entry’ from the ‘Actions’ menu.
2. Browse to the folder where your episode file(s) are that you want to add. To select multiple
episodes drag a box around the filenames.
3. Click OK.
4. If your filenames are not of a format where NMJToolbox2 can parse the season & episode
number you will be prompted to set these details in a popup window.

Deleting a TV Series/Season/Episode

Highlight the node in the treeview that you want to remove and either press the delete key or right
click and select ‘Delete Entry’.

If you delete a season or series then all child seasons and/or episodes are also deleted at the same
time.

Changing TV Show/Season/Episode Details

Highlight the node that you want to change the details on. The relevant details are displayed in the
right hand details tab. Change any of the data and click the save icon on the toolbar.

Note: If you change the season number field, the name of the season in the treeview is automatically
updated as well.

Updating TV Title Details Automatically

Internet updating will query the TVDB website using one of three pieces of information and are used
in the following preference order:

1. Content ID (must start with the letters ‘tvdb’)

2. IMDB TTID (must start with the letters ‘tt’)
3. Series Title.

Highlight the node you wish to update and click the TVDB Update button , select the ‘Internet
Update from TheTVDB’ option on the TV Shows menu or press <ctrl>+I.

22
 NMJToolbox2 User Guide V1.5.1.0

If the node selected is a Series node, all seasons and episodes in that series will be updated.
Similarly if the selected node is a season node, all episodes in that season will be updated.

Note: If the entry that you are updating is incorrect (eg the NMJ detected an incorrect series), it may
have an incorrect Content or TT ID) you must either correct these IDs, or clear them and correct the
series title before clicking the TVDB Update button.

Moving a TV Season or Episode to a different TV Show

Moving is a simple process of drag and drop. When moving a node, all child nodes connected to the
node being moved are moved as well. You can drag from/to the following:

 Episode to a season.
 Season to a series (moves all episodes in that season to the new series).

Moving a TV Season or Episode to a New TV Show

1. Select the season or episode that you want to create a new series from.
2. Right click the node and select ‘Move to a Completely New Series’.

The current series will be duplicated and the selected node (and any child nodes) will be moved to
the new series.

Once the new series is created and the nodes are move you can then change the series name to
what you require and update from the TVDB to get the new correct information (remember to
remove the TTID and Content ID fields before clicking the update – unless you correct the Ids first).

Moving a Movie to a TV Show

1. Select the movie node that you want to move to TV.

2. Right click and select ‘Move to New TV Show’.

A New TV show will now be on the TV Shows tab. The show will have the same name as the movie
that was moved. This name can be changed/edited as normal.

Note: The IMDB and Content Ids will still contain the ones from the movie that was moved – these Ids
should be cleared. Also note that the ‘episode’ created is placed in a season number 99. This can be
changed in the season details screen on the right. You can then update the data from The TVDB as
normal once season number and Ids have been amended.

23
 NMJToolbox2 User Guide V1.5.1.0

Music
The NMJ supports music. There are a few points to note on the way that the NMJ handles music.

 It requires all tracks added to be assigned to an album. Even if it is a single track with no real
album to speak of, it must still have an album.
 The NMJ has no concept of multiple disc albums or box sets. You should decide on how you
want these albums to be handled by the NMJ. Ie. Do you want all tracks from all discs in a
single album or each disc of an album to be a separate ‘album’ in the NMJ wall display.
 The NMJ ‘By Artist’ display is by album artist, not track artis. Handy to know when looking
for tracks on a ‘Various Artists’ album.
 Searching in the NMJ by artist does search the artist index (which NMJToolbox2 also adds
the track artist to) so you can find tracks by a specific artist even if they only appear on a
‘Various Artists’ album.

Adding a New Album

Manually Adding an Album

1. Click the Add New Album button on the toolbar.

2. The following screen will be displayed:

3. Click the Add button. An open file window will open where you can select 1 or more (drag a
box around the tracks or shift/ctrl click the required tracks) tracks.
4. When the tracks have been selected in the open file window they will be entered into the
‘Related Audio Track Files’ grid view.
5. The details on the left (if the tracks have tags) will auto complete with the relevant details
from the first track added.
6. You can select tracks and use the Up/Down buttons to amend the track order.
7. Once the tracks are in the order required you can select the ‘Renumber’ button which will
automatically renumber the tracks starting at 1 (the track numbers in the tags are not
affected).
8. Highlight a track and click ‘Remove’ to remove a track from the album list.
9. If your files are mp3 audio by default the ‘Codec’ description will be ‘MPEG Audio’. If you
would prefer the description ‘MP3’ check the ‘MPEG Audio to MP3 on Update’ box.
10. Click OK

The new album will be added into the databse and displayed in the treeview.

24
 NMJToolbox2 User Guide V1.5.1.0

Adding an album/Tracks Using the Scanner

Due to the NMJ restrictions mentioned at the beginning of the music section, the scanner will add
multiple disc & various artists albums in a specific way depending on how you set the metadata tags
in the files that it is adding.

 All tracks added with the same album artist and album title in the tag will be added to one
album.
 If you want each disc of a multi disc album to be a separate album, make each disc album
title different (eg add ‘Disc 1’ etc to the end).
 If you want all tracks to be in a single track entry, set the track number to be in the order you
want the tracks to appear (to avoid having 3 track 1’s, 3 track 2’s etc on a 3 disc album). A
good idea here is to tag the disc number to the beginning of the track number in the tag so
disc 1 track 1 would be track 101, disc 2 track 1 would be 201 etc.

Adding....

1. Click either the Scan for new media or Scan for new MUSIC toolbar button.
2. A progress window will open where NMJToolbox2 will scan all of your paths looking for
media that is not already in the database and add each entry it finds.
3. It will add tracks to existing albums otherwise it will add new tracks and albums as required.

NOTE: The scanner will only add files that have metadata tags within them. This currently includes
mp3, FLAC, Ogg and m4a(AAC) files.

Adding a Track to an Existing Album

 In the treeview, select the album that you want to add a track to.
 Either; Right Click the album node and select ‘Add Track’, select Actions->Add to Entry from
the menus or press <ctrl>+A
 In the file browser window browse and select the track(s) taht you want to add to the
album.
 Click OK.
 NMJToolbox2 will add the tracks using the tag data if required.

NOTE: The album details (if any) from the tags are ignored adding with this method as you are
directly specifying which album they belong to by selecting the node in the treeview to add to.

Deleting a Track or Album

 Select the track or album in the TreeView that you want to remove.
 Either; Right click and select the relevant delete option, select Actions->Delete Entry from
the menus or press the Delete key on your keyboard.
 If you use the delete key option you will be asked to confirm if you want to delete the entry.
This is to avoid deleting something by mistake by inadvertently pressing the delete key.

25
 NMJToolbox2 User Guide V1.5.1.0

NOTE: If an album node is selected when deleting all of the tracks assigned to that album are also
removed from the database. Your media files are NOT deleted if using the NMJToolbox2 default
settings.

Changing a Track or Album Details

 Select the album or track that you wish to change the details of.
 Amend any details in the details tab on the right.
 Click Save (if you do not have the ‘Auto Save’ setting turned on.

NOTE: For the album details to be amendable, select the Album node in the tree (the track details will
be greyed out). To amend the track details select a track in the TreeView and the track details will
become amendable, the album details will be greyed out.

Updating Audio Album or Track Details Automatically

 Select the album or track node that you wish to update

 Click the MediaInfo Update button on the toolbar.
 The details currently held in the track’s tag will be inserted into the database. If the node
selected is an album, all of the tracks linked to the album will be updated.

Moving a Track to a Different Album or Merging Albums

 Select the album (1) or track (2) node that you wish to move
 Drag and drop it onto the album that you want to move it to.
 If the node being dragged is an album node, all tracs in that album will be moved to the new
album that you drop the node on to. You will be asked to confirm that you wish to move all
of the tracks to the destination album.

26
 NMJToolbox2 User Guide V1.5.1.0

Playlists

Adding a New File Based (m3u) Playlist

Adding a new NMJ Based Playlist

Editing an NMJ Based Playlist

27
 NMJToolbox2 User Guide V1.5.1.0

Scanning Specific Folders

If you do not want to scan all of the paths in your database, for example you only want to scan a
specific folder that you know you have added some new files, you can scan a specific folder (and it’s
sub-folders).

NOTE: What is scanned for depends on which tab is currently selected.

If the Movies or TV tab is selected, only video files are scanned for (both movies and TV are scanned).
If the Music tab is selected, only music files are scanned for.
If the Playlist or Photo tabs are selected, the scan folder function does nothing.

Performing the Scan

 Select the tab for the type of files that you want to scan for (if Movies or TV is selected both
movies and TV episodes are scanned for).
 Select either Actions->Scan Specific Folder from the menus or press F9
 A folder browser window will allow you to select the folder to scan (the initial folder it
appears at will be the folder for the currently selected node – if any).
 Click OK. NMJToolbox2 will check if the path selected is valid for the database currently
open. You will receive an error message if the path is not valid.
 If the path is valid then NMJToolbox2 will scan the selected folder and sub-folders for media
of the required type and add them to the database as it would on a normal full scan.

28
 NMJToolbox2 User Guide V1.5.1.0

Unattended/Scheduled Scanning
NMJToolbox2 has the facility to be run from the commandline. This give the facility to be run via a
batch file/shortcut and scheduler application and scan then close itself down automatically.

Running the command:

Nmjtoolbox2.exe /?

Will open NMJToolbox2 and give the following help dialog:

For example, to scan a database scanning just video (TV and movies) and updating the ratings from
the IMDB you would use the following command(s) – Assuming NMJToolbox2.exe is in the
C:\NMJToolbox folder:

cd C:\NMJToolbox
NMJToolbox2.exe “X:\nmj_database\media.db” /VIDEO /IMDB

The database path has been enclosed in quotes, in the above example it is not necessary but if you
have spaces anywhere in the path then the quotes will be required. So, it is good practice to always
wrap the DB ath in quotes.

Having no switches on the end is the same as having /ALL. This would scan video, music and then
update all ratings from IMDB.

29
 NMJToolbox2 User Guide V1.5.1.0

NMJToolbox2 Remote Control

NMJToolbox2 has basic remote control functions. This allows you to play, fast forward, rewind,
pause, change subtitle and audio tracks etc.

You can control any PCH that you have on your network as long as it has access to the databse that
you currently have loaded in NMJToolbox2.

NOTE: You do not have to be in the NMJ on the PCH that you are controlling for the remote
functionality to work.

There are 2 tabs for the remote control; Main Controls (1) and lesser used controls (2):

For the remote to be enabled you must have:

 A node selected in the treeview.

 In the ‘Popcorn Hour’ field enter the network name or IP address of the PCH you want to
control. Alternatively you can click the ‘Find Popcorn Hours’ button and it will look for all
popcorn hour machines on your network.
 When the popcorn hour field is completed the DB Share dropdown list will be populated.
Select from the list the share that holds the media DB that you are currently editing.

The remote buttons should now be enabled and you can control the playback of the specified
Popcorn Hour.

When playback starts the status box at the bottom will be completed with an image of the title
currently being played and a few other details such as subtitles being shown etc.

30
 NMJToolbox2 User Guide V1.5.1.0

Remote Control Playback Otions

Whilst playing back a video title, the controls on the remote ‘Options’ tab will be available. If the
title being played has multiple subtitles or audio tracks, you can switch directly between them.

Other common button functions from the actual PCH remote control are also available such as
numeric, navigation, title, return and home.

Utilities Menu
There are various utilities available, some that correct incorrect data, others that allow you to
customise the way that the NMJ displays or works. The following is a list of what each menu option
will perform.

Fix Video Count & Type

This utility processes all entries for video types (movies and TV shows) and completes the following:

1. Sets the count of video files in each movie (eg 1 for a normal movie, 2 for a movie made of 2
video files etc.).
2. Sets the count of episodes in a particular TV season.
3. Sets the total count of episodes in a TV series (ie the total of the count of episodes in all
seasons in that series).
4. Sets the internal title type of each record in the database so series are tagges as series,
seasons are tagged as seasons etc.

If you have an issue in the NMJ where a TV season has entries named ‘Unknown’ and that entry will
not play it is usually caused by the episode count being incorrect for that TV show, this optin should
correct that issue for you.

Fix TV Errors

31
 NMJToolbox2 User Guide V1.5.1.0

This utility fixes various issues found with TV series. If you get a message stating that errors were
encountered when changing to the TV Shows tab you should run this option to see if it can fix the
errors. Currently this option will attempt to fix:-

1. Episodes appearing more than once in the database but each episode is linked to a different
series.
2. Database ‘EPISODE’ records that have no corresponding entry in the ‘SHOWS’ table. Every
entry must have a ‘SHOWS’ record without exception.
3. Episodes where there is no SHOWS record for the season. NMJToolbox2 will attempt to
work out what the season record should be and create it.

Fix ‘\’ in Paths

All PCH paths in the database must be in unix/linux format. This means that a ‘\’ (Windows format)
should never appear in paths (video and image paths). This utility simply processes all paths and
switches any ‘\’ it finds to ‘/’.

Bulk Get IMDB Ratings

By default, the NMJ and NMJToolbox2 use the movie & TV ratings from either the Movie DB ot The
TV DB. With these sites generally having far fewer ratings per title the ratings can be wildly skewed
(fanboys and haters). NMJToolbox2 can process every title in the DB and look for the rating for the
movie or show on IMDB and update the rating to this.

There are 2 other options that should be noted that work in conjunction with this option.

Settings -> Use IMDB for Ratings

Turn this option on to make NMJToolbox2 automatically use the IMDB ratings when adding new
items. It does not set the IMDB rating for existing items, you need to use the Bulk Get IMDB Ratings
option for this.

Settings -> Round Up IMDB Ratings

This option when enabled will round the IMDB rating to the nearest whole number. The NMJ rating
is in half stars up to 5, and it always rounds down.

The IMDB rating is out of 10. If a movie for example, has a rating of 7.8 on IMDB the NMJ would
round this down to 7 and show 3.5 stars.

If this option is set, NMJToolbox2 will round this number to 8 as 7.8 is nearer to 8 than 7 which will
force the NMJ to display the movie as 4 stars.

Delete Orphaned Records

This option will process your whole database and fix or remove records that are in error. It is not a
fix all option; it fixes certain things but not everything! It currently will attempt to correct:

32
 NMJToolbox2 User Guide V1.5.1.0

1. Checks if an entry for a TV episode has more than one video file linked to it and removes all
but the first one. The NMJ does not support multiple file TV episodes.
2. Adds missing VIDEO_PROPERTIES records. All VIDEOS records must have a corresponding
VIDEO_PROPERTIES record which stores details such as codec, resolution etc.
3. Removes any CAST records that are not referenced by any movie or TV entry.
4. Removes SHOWS records that are flagged as a TV episode but there are no records in the
EPISODES table for it.
5. Removes VIDEO_PROPERTIES records where there is no matching VIDEOS record.
6. Removes Genres records not referenced by any movie or TV show.
7. Removes VIDEOS records where there is no corresponding SHOWS record.
8. Removes show links records where there is no video file for it.
9. Removes SHOWS records that do not have video records linked to it (as long as the SHOWS
record is not a TV Series or Season – these do not have videos records).
10. Removes SHOWS records flagged as a TV series but the series does not exist in the EPISODES
table.
11. Removes Season records where there is no series record for it.
12. Removes poster records that are not linked to any show.
13. Removes synopsis records not linked to a show.
14. Removes people (cast) records that are not linked to a show.
15. Removes indexes for videos where no show exists.
16. Adds poster records for shows that currently do not have one.
17. Deletes music album indexes where the songs are not in the database
18. Deletes music album records that have no songs attached to them
19. Delete photo albums where there are no photos linked to it
20. Remove unused Music person records.
21. Remove unused music genres

Note: This option fixes issues in sequence which means fixing one thing may create another scenario
that may have already been processed/fixed. For this reason it is recommended to run this option
multiple times until it no longer reports that it has fixed anything and simply states ‘Process
Complete’.

Rebuild Index

Removes all index record entries and rebuilds the records with the data currently in the database.

This should correct any issues that you have where movies or TV shows either do not appear in the
NMJ ‘Category View’ or they appear under the wrong index section.

Clean Up Image Folders

When removing entries from the database the only thing removed is the reference in the database.
The actual images are not removed. This is because you may want to actually keep the artwork.
This option will process all images in your nmj_database/media folder and see if they are being
referenced by anything. If there are no references to the image a backup sub-folder will be created
and the image will be moved there. If you no longer want the image(s) then you can clear or delete
this backup folder.

33
 NMJToolbox2 User Guide V1.5.1.0

Fix Subs (Android)

When a subtitle entry is internal and has no ‘language’ set it generates an error in NMJNavigator for
Android. This option sets all languages to English as a default when the record entry has no
language.

Edit Indices

When viewing the NMJ in Category View, entries are in columns with letter headings (A, B, C-D etc).
You can edit/split/merge these headings to whatever you require using this option.

Remove Backups

Each time you open a DB in NMJToolbox2 or use an option which may have a major effect on the
databse (eg scanning), NMJToolbox2 automatically takes a backup just in case anything goes badly
wrong. You can restore this backup by deleting your media.db and renaming one of the backups to
media.db.

This option will process your nmj_database folder and delete all backup files that it has created
except the backups created today.

Trim Cast Entries

There is a setting on the ‘Settings’ menu allowing you to select how many (max) cast entries to add
to an individual movie or TV episode. If this is set to 0 then all cast entries on the internet query will
be added. If anything higher than 0 is entered then that is the maximum number of cast entries to
add (excluding the director(s).

Trim Cast Entries processes all movies and TV shows and sets the number of cast entries to the
‘Maximum Cast Entries’ setting. Any extra cast are removed from the entry/database.

Rebuild SCAN_DIRS Ids

There was an issue in previous releases of NMJToolbox2 whereby it could potentially get the
SCAN_DIRS_ID incorrect. This would only happen if you removed and added paths to your DB and
only have any effect on you if you then removed the path from the database using NMJToolbox2 or
the NMJ. The effect would be that it would potentially remove the wrong video entries from the
database.

This option will correct the SCAN_DIRS_ID to the correct value.

Version 1.5.0.10 and onwards has this bug corrected so no new errors should occur. So with this in
mind you should only ever need to run this option once and your database should be correct moving
forward.

34
 NMJToolbox2 User Guide V1.5.1.0

Bulk Actions Menu

This menu has a number of options/utilities that will carry out updates to your whole database.

Update All Audio MediaInfo

Rescans every music track in your database and updates the information from the current metatags
contained in the files. This includes titles, artists, album titles etc.

Scan and Add New Media

This will automatically scan all of your defined folders in the database for any media files that are
not already in the database and add them. This option scans for both video (movies & TV) and
audio.

Fill in Missing Video Images

Your database ‘POSTERS’ table will be scanned and any blank fields in it (posters, thumbnails, fanart)
will be retrieved and added where possible.

Local fan art will be added in preference to any internet images. The file must be conform to the
following criteria:

 It must be a jpg image

 It must be called folder.jpg or <name of the media file>.jpg
 If it is for a TV show it must be named the same as the first episode video file in that season.
 It must exist and have artwork on TheMovieDB or TheTVDB (if no local artwork exists)

For NMJToolbox2 to correctly get the image from the internet the movie or TV Show record must
have a TTID or Content ID assigned to it.

Note: If you run this option and you find that an image is not added for the title and the criteria
above is met then it may be that the image field for that entry has some data in it but the image path
is invalid or not showing for some reason. To correct this either double-click the image box or right
click it and select ‘Remove Image Reference from the Database’. The database field will be blanked
out and the option should now get the artwork for the title.

Fill in Missing Audio Images

If an album entry has no artwork associated with it NMJToolbox2 will scan the folder that the media
files are contained in for local artwork and if not found it will scan the media files themselves for
embedded album images in the metadata tags.

Local artwork for album images should be named (in preference order):

 Cover.jpg
 Front.jpg
 Folder.jpg

35
 NMJToolbox2 User Guide V1.5.1.0

Remove Deleted File Entries

This option will get every entry in your database and look at the paths to see if the media file can be
located. If the file cannot be found the entry for that media file is automatically removed.

This option is useful for people who continually add and delete media from their shares (like TV
episodes).

Optimise Images

By default NMJToolbox2 creates images larger than the NMJ expects (it improves image quality) but
it can slow the NMJ down. Syabas/Cloud Media have since removed the facility of the NMJ to resize
fan art. People with NMJ databases administered with NMJToolbox2 may find image issues such as
‘zoomed’ fan art as the fan art by default is 1080P.

This option will process every image of the type you select and resize it to the NMJ’s native size.

Note: There is an option on the settings menu ‘Use 720P wallpapers’ which will make the fan art
added to any new entries conform to the NMJ native dimensions (i.e. any new fan art will not look
‘zoomed’).

Export .nfo files

Selecting this menu option displays the following window:

Here you can specify what to export nfo files for (movies, TV or both) and whether to overwrite any
nfo file that already exists.

On selecting OK your database will be processed and an xml file generated to the PCH ‘info’ button
xml with some XBMC xml tags added. So this nfo file should also then work on pressing the ‘i’
button on your remote in file mode view.

The nfo.xml file will be saved in the same folder that the media file resides.

36
 NMJToolbox2 User Guide V1.5.1.0

FAQ/Troubleshooting

Setup

Q. Why do I have to set paths?

A. NMJToolbox2 is the only editor that supports both media on a different drive/share to where the
database is and the only one that supports multi-shares. For this reason it cannot assume the media
and DB are in the same location so it has to be told how windows get to the location(s) of your
media that the NMJ has in it's database.

Q. What do I put in the WINDOWS_PATH section of the Paths->Settings screen?

A. You should look at the PCH_PATH entry and then point the WINDOWS_PATH to exactly the same
location ie going to whatever is in the WINDOWS_PATH in Windows will show you exactly the same
content as if you went to what is in the PCH_PATH on your Popcorn Hour.

Q. When I go into the Paths screen in NMJToolbox2 there is nothing entered in the
PCH_PATH column, so what do I put in the WINDOWS_PATH column.
A. Simple answer, nothing. This is indicating that the media is on the same drive as the database and
NMJToolbox2 will interpret it as such. However, you must still set the 2 dropdown boxes to their
correct settings otherwise your artwork will not display.

Q. Does NMJToolbox2 support UNC paths (eg \\<servername>\<folder> etc.)?

A. Yes, however due to the way NMJToolbox2 works if you get the path right but not the [i]exact[/i]
case in the path, any additions of new media or changes in artwork may not be added correctly.

For this reason it is recommended to map windows drive letters to all of your shares/drives and use
these in NMJToolbox2.

Q. What are the dropdown combo boxes for in the Paths->Settings window.
A. As the NMJ/PCH has 2 ways of referring to artwork in it's database it needs to know if your media
& DB are on the same drive and if that drive is internal to the PCH or not. It only really has an effect
if your media.db is on an internal drive and your media is on a network share. If this is the case set
the DB location to 'PCH Internal Drive' and media location to 'Network Share', otherwise should be
safe to leave both to 'Network Share'.

Q. I select a different language setting in Settings->UI Language but the application is still
in English....
A. For the UI to be able to change it needs extra dll files for the language you are changing to.
Download the language_xx.zip for your required language (links are in the first post of this thread)
and extract the zip file to the same folder that your NMJToolbox2.exe is in.

You will need to close & re-open NMJToolbox2 for it to recognise the new DLL file and your language
change should now work.

37
 NMJToolbox2 User Guide V1.5.1.0

Editing

Q. How do I change the artwork on a movie/tv show/tv season?

A. Highlight the entry in the tree view that you want to change the artwork for. If the entry has
either an IMDB 'tt ID' or a 'Content ID' then you can simply click the 'TMDB/TVDB' images button
where you will be presented with the selection that is available from their respective websites. Use
the < & > buttons to navigate to the ones that you want, place a check in the relevant checkboxes for
the images you want to add/replace and OK out.

Q. That's fine but what if I don't like those images or want to use my own?
A. The image boxes support drag and drop. You can either drag a .jpg onto the image box that you
want to update or you can drag an image directly from a web page in your web browser onto the
image box(es).

Note: depending on how the images are embedded on the web page the drag & drop of images from
them may not work. It all depends on the website's implementation of embedding images.

Q. An entry has images but I don't want any image, how can I remove the image?
A. Double click the image. You will be asked to confirm if you want to delete it (it only removes it
from the database/NMJ it does not remove the actual image file). You can also right click the image
and select ‘Remove Image Reference from the Database’.

Q. I have a movie/TV Show that has the details for another (incorrect) film/TV Show.
How to I get the correct details?
A. NMJToolbox2 can get details using any of 3 ways:

1. Content ID
2. IMDB ID
3. Title.

They are used in that order. So, if there is a content ID it will use that, if there isn't but there is an
IMDB ID then it will use that but if no 'IDs' then it will use the title.

Using an ID points directly to a specific title so if the Content/TTID is wrong the details will still be
wrong. You can either correct the 'ID' field and click the relevant toolbar button to update from the
website.

If you want to search by title then make sure you clear the IMDB ID and Content ID before clicking
the update from the internet button. If there are multiple title matches you may be given a list of
movies to choose from.

Q. The Title is wrong, how do I change it?

A. It is the name in the tree and works the same way as editing in Windows explorer. Select the
entry and then click a second time to edit - or press ‘F2’ when the entry in the tree is selected.

38
 NMJToolbox2 User Guide V1.5.1.0

Q. I want to edit the 'Search Title - How do I do that?

A. NMJToolbox2 will format the search title automatically depending on the settings you have set.
By default it will set it to the same as the title you set. If the title starts with an article (eg 'The' 'A',
'An' etc.) NMJToolbox2 will move this word to the end and index the title on the 2nd word.

You can turn off moving of the article by selecting 'Do Not Process Title Article' on the settings menu.

As of release 1.5.0.11 you can directly edit the search title. Any modification you do to the search
title needs to be indexed. It will be indexed when you press enter whilst in the Search Title box or
when it loses focus.

Q. How do I change the Cast/Keywords/Genre(s) of an entry?

A. Either click on the relevant toolbar button (2 people with a pencil for Cast, Paper with a Key on it
for Keywords, 2 Theatre masks for Genres) or you can double click the cast, keyword or genre boxes
as well.

When editing the genre for a music album, an extra option is displayed and automatically ticked.
When adding a genre to the album and this option is ticked, all of the tracks on that album will also
have that genre added to it.

Scanner

Q. How do I stop the scanner from scanning a particular share or folder?

A. You can simply add a file to the folder to be ignored (all child folders of that folder will also be
ignored): -

 .mjbignore (the folder will not be scanned for anything)

 .no_all.nmj (the folder will not be scanned for anything)
 .no_video.nmj (video files will be ignored, music etc will still get scanned)
 .no_music.nmj (music files will be ignored, video etc will still get scanned)
 .no_photo.nmj (image files will be ignored, video etc will still get scanned)

You may put one or more of the above files in a folder. For example, if you wish a folder to be
scanned only for video files, not music or photo files, add both .no_music.nmj and .no_photo.nmj to
the folder.

Note: If you are a user that has a lot of local cover and fan art for your media files you may want to
put at least .no_photo.nmj into the root of your video folder(s). If you do not do this the NMJ scanner

39
 NMJToolbox2 User Guide V1.5.1.0

will add all of your movie and TV covers to the photo section of the NMJ as well. This is not an issue
with NMJToolbox2 currently as it does not have a photo section scanner.

Q. Using the scanner the progress window pops up and closes without anything being
added.
A. This is more than likely due to the WINDOWS_PATH being inaccessible from Windows. This
commonly occurs if the remote device has been reset/rebooted whilst your windows PC has been
on.

Open windows explorer and simply access all the share drives that NMJToolbox2 should scan and
then try the scan facility again.

Q. The scanner adds my files but some entries are wrong, why?
A. 99% of the time this is down to the naming of your files/folders. If you want to be as certain as
you can be that the entry will be scraped correctly use the following format:

<film name> (<year>).ext

Underscores and periods are permitted between words and will be stripped for the internet query.

Anything else (group tags, format, source etc) such as 'BluRay' are not automatically stripped and
may cause the query to fail. To handle this you can add text to the list of words to strip before a
query. You set these in Settings->'Ignore Words in Filenames...'

Q. The scanner added one or more TV episode into the Movies section...
A. Again, this is down to your file name convention. NMJToolbox2 checks the filename for
season/series indicators. If these are not found then the file is deemed to be a movie. The format
needs to be one of the following formats:

<series name> S9999E9999 <optional episode title>.ext

or
<series name> 9999x9999 <optional episode title>.ext

The first '9999' above is the season number, the second is the episode number. These can be 1 to 4
digits long with or without leading zeroes.

Q. I have a file that is multiple TV episodes in one, how do these get added as separate
episodes in the NMJ?
A. Name as above but with multiple 'E' entries. E.g 'Game of thrones', season 2 episodes 3-5 would
be:

Game of Thrones S02E03E04E05 <optional text>.ext

Q. I have some 3D files but they are not marked as 3D automatically when added with
NMJT2 either manually adding or via the scanner.
A. For NMJT2 to recognise that the entry is 3D it needs to see either '3DSBS' or '3DTAB' in the
filename. E.g:

40
 NMJToolbox2 User Guide V1.5.1.0

Avatar (2009).3DSBS.mkv

Common NMJ / NMJToolbox2 Questions & issues

Q. In NMJToolbox2 why are some of the names in the Treeview greyed out?
A. This indicates that the title/entry has been watched at least once. You can see at a glance what
entries have not been watched.

Q. What do the different icons mean in the Treeview?

A. Depending on the item type depends on the image representing it in the tree:

 Movie Entry (2D).

 Movie Entry (3D).
 Media file for a movie/TV Episode.
 TV Series
 TV Season
 Music Album
 Music Track
 Music Playlist
 Photo Album
 Photograph/Image

Q. I go into a TV season and see one or more Episodes called 'Unknown' and none of them
play.
A. This is due to the number of episodes on the season record being incorrect/too high. Run the 'Fix
Video Count & Type' option on the Utilities menu.

Q. There are entries in the NMJ, they play OK but the artwork is not showing. However,
the artwork shows when viewing the entry in NMJToolbox2.
A. This is due to the combo boxes in the Paths screen being set incorrectly for your setup. It is highly
likely that you have the DB on your internal drive but your media is elsewhere. Set the combo for
'Media.db path' to PCH Internal Drive' and the combo for 'Media File Location' to 'Network Share'.

Q. I see an entry in NMJToolbox2 but I can't find it in the NMJ, why is this?
A. When viewing in 'Category View' mode the NMJ uses the index table. Your 'missing' entry is
probably just missing from the index. This can be fixed by running Utilities->Rebuild Index then
selecting Video.

Q. When I view details on an entry in the NMJ the wallpaper/Fanart is 'zoomed' in.
A. The NMJ is 720P, by default NMJToolbox2 sizes fanart to 1080P. Originally the NMJ would resize
these wallpaper images but this facility has been removed for speed and memory considerations.

You should tick the 'Use 720P Wallpaper Images' on the Settings menu. This will make sure all
subsequent artwork changes are correct.

41
 NMJToolbox2 User Guide V1.5.1.0

If you wish to correct existing artwork you can run Bulk Actions-> Optimise Images->Video
Wallpapers

Q. Using the 'Fill in missing Video Images' option does not seem to have filled in all of the
missing images.
A. Images will only be completed if certain conditions are met:

1. There must be a Content or IMDB ID for that entry.

2. It must exist (and have artwork) on the MovieDB or TheTVDB.
3. There must NOT be a path in that existing image entry.

To Check if there is an existing path for the image for an entry select the entry in the treeview then
hover your pointer over the image box. If the tooltip does not say 'No Image' then a path is there.
To remove that path, double click the picture box.

To Be Continued......

42