Changelog: v1.0.4 03.05.2024
Fixed
.tw3
and.twee
file extensions being ignored for populating the Passage/Tags listboxes.
A tool to split huge twee files into smaller ones with a User customizable Folder and File Structure.
Application version: 1.0.4
This project is maintained by
A self-contained Desktop application for turning the large files, which come from decompiling a Twine html file, into smaller ones with options to define your folder and file structure.
This is an unsigned Application, which accesses the file system so Windows Defender might interfere with this application, if writing the files takes significant longer then it had reading the passages and tags (after inputting a source file) then that's probably due to Windows Defender. Not suggesting turning it off, but doing so can make a difference of the process taking an Hour or less then a Minute depending on file size.
Once it’s downloaded and running there are 3 Main things:
- The Input file you can choose the file to split as Input File.
- An Output folder in which all Files and Folders should be created in.
- Separation Rules, the list on the left side shows all current Separation rules, these rules determine how Passages get sorted and/or Merged.
You can type directly in those Textboxes to set an Input file or Output Folder, or use the Open File/Folder buttons. After you selected an Input file, it will read the Passage names and Tags and add them in the lists on the right side.
When you have a Separation-Rule open you can quickly add/remove a Passage/Tag name to the rule using the Listboxes on the right (left/right mouse click).
You can alter Separation Tools by clicking on the Listbox Item on the left, add new ones by clicking the Button “New Rule” under the Listbox for the Separation Rules.
Once you have selected a rule, a Panel in the middle will open up, in there you’ll find the settings.
Rule Name:
This field can be ignored since it’s only for the application and only affects the name in the list on the left.Folder Name:
Setting this field will create a folder or even Folders within Folders.Passage Names:
A list of passage names that will be associated with this rule.Tag Names:
A list of Tag names that will be associated with this rule.Options:
In here your search criteria can be set in which files should be sorted into a folder and/or merged into a single file.
Matches Exactly:
If a Passage matches exactly one of the Passage/Tag Names from the list then it will be sorted in the given folder.
Starts With:
Meant for prefixes as an exampleStory
would Match withStoryData
andStoryTitle
.
Contains:
Only needs to appear within the string, eg.:Widget
containsidg
.
Ends With:
Meant as a Suffix, same asStarts With
just that it searches how the passage/tag ends.
Merge into One:
When selected it will merge every match into a single file, for exampleStoryData
andStoryTitle
would be contained by 1StoryData.tw
file.
Once you are done setting up the rules you can hit the red Separate Passages!
button.
Setting rules is optional you can also just hit the red "Separate Passages!" button immediately
Here’s an example workflow (left mouse click to enlarge)
Fixed
.tw3
and.twee
file extensions being ignored for populating the Passage/Tags listboxes.