Hi Alpines,
I have asked "JayShoe" to provide the link to the manual.
In the mean time though here's some info on importing based on file masks. In time we will add configuration screens for this stuff.
The collection configuration is stored in Jukebox Jockey's AppData\Settings\collections.ini file.
Each collection has an entry [Music], [Karaoke], . Now, unless you aren't going to use the [Video] collection for Music Videos I would suggest that you create a new collection [Movies]. When using file masks it's important to remember that you can only use one file mask for the entire collection, the reason being that you have to tell JJ what the file names are meant to represent, JJ can't figure it out for itself. So every media file read in will use the file mask (unless it is actually tagged) that you specifiy.
Now, before continuing it's very important to remember that if you're using file masks then EVERY media file scanned in for the specified collection (that is not actually tagged) must be named in exactly the way otherwise the interpreted information will not be correct.
OK, so the file masks have few properties which you can see in the ini file, here's the standard [Video] section showing only the relevant properties:
[Video]
...
FileMask.Mask=%n - %t
FileMask.AlbumFromParent=1
FileMask.ArtistFromParent=1
FileMask.AlwaysUseMask=0
The values available for the file mask are:
%n = track number
%t = title
%a = artist
%b = album
%g = genre
We have assumed that a "normal" collection is likely broken down using a structure of "Artist\Album\01 - Track.mp3". So we have
- "FileMask.AlbumFromParent=1" (1 is TRUE and 0 is FALSE) so we're saying that the name of the Album should be taken from the parent folder.
- "ArtistFromParent=1" saying that that Parent folder's Parent is the artist, if "AlbumFromParent" wasn't 1 then it would simply take the first parent folder as the artist.
- We then have a "FileMask=%n - %t" which says that our tracks are named using first the track number then "space dash space" then the title of the track
- The "FileMask.AlwaysUseMask=0". Because it's "0" we're saying don't always use the file mask, only use it when the track is not tagged. "Not Tagged" is interpreted as not having the Artist Tag or not having the Title tag, if one of these values is missing we need to read from the file since they are key pieces of information and we can't locate a track without them
Now, for movies, the situation is a little different. They typically won't have an artist and you may simply just want the title. You could go a step further and use a Genre too if you really wanted to so you could have "Action" and "Drama" and "Thriller" I guess. So for movies I would recommend these settings:
[Video]
...
FileMask.Mask=%t
FileMask.AlbumFromParent=0
FileMask.ArtistFromParent=0
FileMask.AlwaysUseMask=0
Which say that the files are named only with the title and we're not reading album or artist info from anywhere.
If you have your files categorised into different folders for different genres you could have a filemask of "%g\%t" which says that the parent folder is the name of the genre. If the file names have the genre in them (I guess this is unlikely) then you may use "%g - %t".
On top of all that, all of JJ's preconfigured views are designed for music and work on the assumption of tracks having an Artist and a Title. So, to work with JJ's default views you could set "FileMask.ArtistFromParent=1" so that all the movies show up with an artist which is the name of the folder they are stored in, this might be a good start to at least get them imported and start messing around with them. Alternatively we could create a new view for you that simply lists videos from your "Movies" collection by title.
I hope that's enough info to get you going.[Video]. Now, unless you aren't going to use the collection for Music Videos I would suggest that you create a new collection [Movies]. When using file masks it's important to remember that you can only use one file mask for the entire collection, the reason being that you have to tell JJ what the file names are meant to represent, JJ can't figure it out for itself. So every media file read in will use the file mask (unless it is actually tagged) that you specifiy.
Now, before continuing it's very important to remember that if you're using file masks then EVERY media file scanned in for the specified collection (that is not actually tagged) must be named in exactly the way otherwise the interpreted information will not be correct.
OK, so the file masks have few properties which you can see in the ini file, here's the standard [Video] section showing only the relevant properties:
[Video]
...
FileMask.Mask=%n - %t
FileMask.AlbumFromParent=1
FileMask.ArtistFromParent=1
FileMask.AlwaysUseMask=0
The values available for the file mask are:
%n = track number
%t = title
%a = artist
%b = album
%g = genre
We have assumed that a "normal" collection is likely broken down using a structure of "Artist\Album\01 - Track.mp3". So we have
- "FileMask.AlbumFromParent=1" (1 is TRUE and 0 is FALSE) so we're saying that the name of the Album should be taken from the parent folder.
- "ArtistFromParent=1" saying that that Parent folder's Parent is the artist, if "AlbumFromParent" wasn't 1 then it would simply take the first parent folder as the artist.
- We then have a "FileMask=%n - %t" which says that our tracks are named using first the track number then "space dash space" then the title of the track
- The "FileMask.AlwaysUseMask=0". Because it's "0" we're saying don't always use the file mask, only use it when the track is not tagged. "Not Tagged" is interpreted as not having the Artist Tag or not having the Title tag, if one of these values is missing we need to read from the file since they are key pieces of information and we can't locate a track without them
Now, for movies, the situation is a little different. They typically won't have an artist and you may simply just want the title. You could go a step further and use a Genre too if you really wanted to so you could have "Action" and "Drama" and "Thriller" I guess. So for movies I would recommend these settings:
[Video]
...
FileMask.Mask=%t
FileMask.AlbumFromParent=0
FileMask.ArtistFromParent=0
FileMask.AlwaysUseMask=0
Which say that the files are named only with the title and we're not reading album or artist info from anywhere.
If you have your files categorised into different folders for different genres you could have a filemask of "%g\%t" which says that the parent folder is the name of the genre. If the file names have the genre in them (I guess this is unlikely) then you may use "%g - %t".
On top of all that, all of JJ's preconfigured views are designed for music and work on the assumption of tracks having an Artist and a Title. So, to work with JJ's default views you could set "FileMask.ArtistFromParent=1" so that all the movies show up with an artist which is the name of the folder they are stored in, this might be a good start to at least get them imported and start messing around with them. Alternatively we could create a new view for you that simply lists videos from your "Movies" collection by title.
I hope that's enough info to get you going.[Video] collection for Music Videos I would suggest that you create a new collection [Movies]. When using file masks it's important to remember that you can only use one file mask for the entire collection, the reason being that you have to tell JJ what the file names are meant to represent, JJ can't figure it out for itself. So every media file read in will use the file mask (unless it is actually tagged) that you specifiy.
Now, before continuing it's very important to remember that if you're using file masks then EVERY media file scanned in for the specified collection (that is not actually tagged) must be named in exactly the way otherwise the interpreted information will not be correct.
OK, so the file masks have few properties which you can see in the ini file, here's the standard section showing only the relevant properties:
[Video]
...
FileMask.Mask=%n - %t
FileMask.AlbumFromParent=1
FileMask.ArtistFromParent=1
FileMask.AlwaysUseMask=0
The values available for the file mask are:
%n = track number
%t = title
%a = artist
%b = album
%g = genre
We have assumed that a "normal" collection is likely broken down using a structure of "Artist\Album\01 - Track.mp3". So we have
- "FileMask.AlbumFromParent=1" (1 is TRUE and 0 is FALSE) so we're saying that the name of the Album should be taken from the parent folder.
- "ArtistFromParent=1" saying that that Parent folder's Parent is the artist, if "AlbumFromParent" wasn't 1 then it would simply take the first parent folder as the artist.
- We then have a "FileMask=%n - %t" which says that our tracks are named using first the track number then "space dash space" then the title of the track
- The "FileMask.AlwaysUseMask=0". Because it's "0" we're saying don't always use the file mask, only use it when the track is not tagged. "Not Tagged" is interpreted as not having the Artist Tag or not having the Title tag, if one of these values is missing we need to read from the file since they are key pieces of information and we can't locate a track without them
Now, for movies, the situation is a little different. They typically won't have an artist and you may simply just want the title. You could go a step further and use a Genre too if you really wanted to so you could have "Action" and "Drama" and "Thriller" I guess. So for movies I would recommend these settings:
[Video]
...
FileMask.Mask=%t
FileMask.AlbumFromParent=0
FileMask.ArtistFromParent=0
FileMask.AlwaysUseMask=0
Which say that the files are named only with the title and we're not reading album or artist info from anywhere.
If you have your files categorised into different folders for different genres you could have a filemask of "%g\%t" which says that the parent folder is the name of the genre. If the file names have the genre in them (I guess this is unlikely) then you may use "%g - %t".
On top of all that, all of JJ's preconfigured views are designed for music and work on the assumption of tracks having an Artist and a Title. So, to work with JJ's default views you could set "FileMask.ArtistFromParent=1" so that all the movies show up with an artist which is the name of the folder they are stored in, this might be a good start to at least get them imported and start messing around with them. Alternatively we could create a new view for you that simply lists videos from your "Movies" collection by title.
I hope that's enough info to get you going.[Video] section showing only the relevant properties:
...
FileMask.Mask=%n - %t
FileMask.AlbumFromParent=1
FileMask.ArtistFromParent=1
FileMask.AlwaysUseMask=0
The values available for the file mask are:
%n = track number
%t = title
%a = artist
%b = album
%g = genre
We have assumed that a "normal" collection is likely broken down using a structure of "Artist\Album\01 - Track.mp3". So we have
- "FileMask.AlbumFromParent=1" (1 is TRUE and 0 is FALSE) so we're saying that the name of the Album should be taken from the parent folder.
- "ArtistFromParent=1" saying that that Parent folder's Parent is the artist, if "AlbumFromParent" wasn't 1 then it would simply take the first parent folder as the artist.
- We then have a "FileMask=%n - %t" which says that our tracks are named using first the track number then "space dash space" then the title of the track
- The "FileMask.AlwaysUseMask=0". Because it's "0" we're saying don't always use the file mask, only use it when the track is not tagged. "Not Tagged" is interpreted as not having the Artist Tag or not having the Title tag, if one of these values is missing we need to read from the file since they are key pieces of information and we can't locate a track without them
Now, for movies, the situation is a little different. They typically won't have an artist and you may simply just want the title. You could go a step further and use a Genre too if you really wanted to so you could have "Action" and "Drama" and "Thriller" I guess. So for movies I would recommend these settings:
[Video]
...
FileMask.Mask=%t
FileMask.AlbumFromParent=0
FileMask.ArtistFromParent=0
FileMask.AlwaysUseMask=0
Which say that the files are named only with the title and we're not reading album or artist info from anywhere.
If you have your files categorised into different folders for different genres you could have a filemask of "%g\%t" which says that the parent folder is the name of the genre. If the file names have the genre in them (I guess this is unlikely) then you may use "%g - %t".
On top of all that, all of JJ's preconfigured views are designed for music and work on the assumption of tracks having an Artist and a Title. So, to work with JJ's default views you could set "FileMask.ArtistFromParent=1" so that all the movies show up with an artist which is the name of the folder they are stored in, this might be a good start to at least get them imported and start messing around with them. Alternatively we could create a new view for you that simply lists videos from your "Movies" collection by title.
I hope that's enough info to get you going.[Video]
...
FileMask.Mask=%n - %t
FileMask.AlbumFromParent=1
FileMask.ArtistFromParent=1
FileMask.AlwaysUseMask=0
The values available for the file mask are:
%n = track number
%t = title
%a = artist
%b = album
%g = genre
We have assumed that a "normal" collection is likely broken down using a structure of "Artist\Album\01 - Track.mp3". So we have
- "FileMask.AlbumFromParent=1" (1 is TRUE and 0 is FALSE) so we're saying that the name of the Album should be taken from the parent folder.
- "ArtistFromParent=1" saying that that Parent folder's Parent is the artist, if "AlbumFromParent" wasn't 1 then it would simply take the first parent folder as the artist.
- We then have a "FileMask=%n - %t" which says that our tracks are named using first the track number then "space dash space" then the title of the track
- The "FileMask.AlwaysUseMask=0". Because it's "0" we're saying don't always use the file mask, only use it when the track is not tagged. "Not Tagged" is interpreted as not having the Artist Tag or not having the Title tag, if one of these values is missing we need to read from the file since they are key pieces of information and we can't locate a track without them
Now, for movies, the situation is a little different. They typically won't have an artist and you may simply just want the title. You could go a step further and use a Genre too if you really wanted to so you could have "Action" and "Drama" and "Thriller" I guess. So for movies I would recommend these settings:
...
FileMask.Mask=%t
FileMask.AlbumFromParent=0
FileMask.ArtistFromParent=0
FileMask.AlwaysUseMask=0
Which say that the files are named only with the title and we're not reading album or artist info from anywhere.
If you have your files categorised into different folders for different genres you could have a filemask of "%g\%t" which says that the parent folder is the name of the genre. If the file names have the genre in them (I guess this is unlikely) then you may use "%g - %t".
On top of all that, all of JJ's preconfigured views are designed for music and work on the assumption of tracks having an Artist and a Title. So, to work with JJ's default views you could set "FileMask.ArtistFromParent=1" so that all the movies show up with an artist which is the name of the folder they are stored in, this might be a good start to at least get them imported and start messing around with them. Alternatively we could create a new view for you that simply lists videos from your "Movies" collection by title.
I hope that's enough info to get you going.[Video]
...
FileMask.Mask=%t
FileMask.AlbumFromParent=0
FileMask.ArtistFromParent=0
FileMask.AlwaysUseMask=0
Which say that the files are named only with the title and we're not reading album or artist info from anywhere.
If you have your files categorised into different folders for different genres you could have a filemask of "%g\%t" which says that the parent folder is the name of the genre. If the file names have the genre in them (I guess this is unlikely) then you may use "%g - %t".
On top of all that, all of JJ's preconfigured views are designed for music and work on the assumption of tracks having an Artist and a Title. So, to work with JJ's default views you could set "FileMask.ArtistFromParent=1" so that all the movies show up with an artist which is the name of the folder they are stored in, this might be a good start to at least get them imported and start messing around with them. Alternatively we could create a new view for you that simply lists videos from your "Movies" collection by title.
I hope that's enough info to get you going.