File stacking: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{mininav|[[General topics]]|[[Videos]]|[[Video library/Management|Management]] {{l2| [[Video library/Navigation|Navigation]] }}|[[Video library/Naming files|Naming files]]<br/>&nbsp;}}
#REDIRECT [[Naming_video_files/Movies#Split_Video_Files]]
<section begin=intro />XBMC's file stacking feature handles your multi-part videos in a clean, intuitive manner. File stacking combines your multi-part files into a single item in the file list or library. Playback of stacks is completely transparent to you as the user, all parts are automatically queued for playback in order. Stacking is a view option available in videos file mode window. It is always applied when scanning movies into the library.<section end=intro />
 
== How does file stacking work? ==
The stacking function is presented with a list of file items from a directory listing.
# Sort the file list alphabetically.
# PART1, PART2, ..., PART9 directories are collapsed if they contain only one video file.
# Each filename is tokenized into Title, Volume, Ignore and Extension parts.
# For each consecutive filename where all tokens '''except''' Volume match, the file's index in the file list is stored in a vector.
# Once the above condition fails...
## The stack path is generated (eg. "stack://movie-part1.mkv , movie-part2.mkv")
## The stack name is created from the Title Ignore and Extension tokens (eg. movie.mkv)
## The path and label of the first file item are replaced by the stack path and stack name, respectively.
## The remaining file items in the stack are removed from the file list.
# This continues until the file list is exhausted.
 
==Stacking name extensions==
The following are default stacking extensions that can be added to file names
 
'''#''' can be '''1''' through '''9''' or '''A''' through '''D'''. No spaces between the "part" and number.
* {{code|part#}}
* {{code|cd#}}
* {{code|dvd#}}
* {{code|pt#}}
* {{code|disk#}}
* {{code|disc#}}
 
 
You can also use:
*moviename'''#'''.ext
where '''#''' can be '''A''' through '''D'''.
 
== Limits ==
* Stacking is currently only applied to movies.
* Stacking is currently only applied to filenames, not the full path.
* The default expressions will NOT stack files which use only a number as the volume token (eg movie1.avi, movie2.avi). This is intentional due to false positives which can occur with sequels in a flat directory layout. Some solutions to this problem (in order of best to worst) follow...
*# Use a dir-per-movie directory layout, see the '''append''' example of the [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] advanced setting.
*# Rename offending files to match one of the more specific volume tokens (ie. cd1, part1, etc).
*# Create special-case regular expressions for those files that fail to stack (see [[#Fine tuning]]).
 
== Fine tuning ==
File stacking can be tuned by the user to match obscure cases using the [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking advancedsettings.xml setting]]:
 
;<moviestacking>
{{#lsth:advancedsettings.xml|<moviestacking>}}
 
{{forum link2|[[forum:138640|File Stacking multiple CD's forum thread discussion]]}}
 
[[Category:XBMC Manual]]
[[Category:Video Library]]
{{frodo updated}}

Latest revision as of 16:46, 6 January 2019