Creates a Plottr file from a Scrivener project. All the scenes in the Scrivener project's Manuscript folder will show up as Scene Cards in Plottr, with their respective title and synopsis.
It does not and never will synchronise between Plottr and Scrivener. Plottr can already export to Scrivener and they are supposedly working on synchronisation, too.
Characters and Places are created from files in the respective Scrivener folders. Images are exported, too. The content of the files is still missing, though, mostly due to lack of an idea how to parse RTF into something Plottr can understand.
You can simply pass your Scrivener 3 project to the script like so:
python3 scrivx2pltr.py YourProject.scriv
This will create the Plottr file in the same directory as your Scrivener project. If you want it created elsewhere and/or under a different name, use
python3 scrivx2pltr.py YourProject.scriv -o YourChoice.pltr
--flattenTimeline By default, each folder in your Scrivener project's Draft folder will create a separate plotline in Plottr. If you'd rather have all your scenes in one flat timeline, use this option.
--foldersAsScenes Folders themselves will be skipped by default. However, folders in Scrivener can actually have content, much like a file. Use this option if you want your folders to show up as scene cards in Plottr, too.
With --charactersFolder and --placesFolder, you can specify the names of the Characters and Places folders, respectively, if you changed their names in Scrivener.
--maxCharacters and --maxPlaces let you limit the number of Characters and Places, respectively, that will be read from Scrivener. Set them to 0 if you don't want them to be transferred at all.
Use --useLabelColors to color the created Plottr scene cards with the label color the respective scenes have in Scrivener (requires Plottr 2021.3.9).
If you are using Scrivener labels or keywords (or both) to connect scenes and characters, use --labelsAreCharacters and/or --keywordsAreCharacters to make that connection in Plottr, too.
Use --keywordsAreTags to import and use Scrivener keywords as tags in Plottr.
My name is Dirk Haun. I used to be a software engineer but have been doing other things for the past 5+ years. I also haven't written any Python in as many years, so please bear with me.
MIT License, for now. I may change my mind at a later point, but for now there isn't a lot here that's worth protecting anyway. It'll always be open source under an OSI-approved license, promised!