Skip to main content

Plotlines

Plotlines is a tool to help create online choice-based narratives.

Authors create a basic story structure in Inkscape. Plotlines will read the SVG file and generate templates for HTML5 output.

Works-in-progress can be saved in human-readable TOML files. This format is better suited to collaborative editing.

Workflow

Inkscape's Connectors tool makes it easy to design a branching narrative structure.

Story board

You can capture ideas in the title and description fields of both nodes and edges using the Object Properties editor.

When that phase is complete, you use Plotlines to save the structure as a .toml file where the serious process of writing and editing begins.

Finally, you can export to a template tree ready for Spiki to generate the HTML suitable for a static web site on the Internet.

Features

Plotlines can import SVG from either of these editors:

Mode of use CLI options Progress Status
Auto-generation of plot structures Omit -i option Ongoing :x:
Convert Dunnart files to TOML format -i <file>.svg -o .toml Complete :ok:
Convert Inkscape files to TOML format -i <file>.svg -o .toml Complete :ok:
Load and plot a file in TOML format -i <file>.toml Complete :ok:
Load file and generate a Spiki template tree -i <file>.toml -o <dir> Complete :ok:

Usage

python3 -m plotlines.main --help
usage: python -m plotlines.main [-h] [--debug] [-i INPUT] [-o OUTPUT] [--ending ENDING] [--limit LIMIT] [--exits EXITS]

options:
  -h, --help            show this help message and exit
  --debug               Display debug information
  -i, --input INPUT     Specify an input file
  -o, --output OUTPUT   Specify an output file or directory
  --ending ENDING       Set the number of endings [4].
  --limit LIMIT         Limit the number of Nodes and Edges in the graph [100]
  --exits EXITS         Fix the number of exiting Edges from each Node [4]

Metadata

Release files for plotlines 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plotlines 0.5.0
File Size Uploaded Provenance
plotlines-0.5.0.tar.gz 72.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for plotlines 0.5.0
File Interpreter ABI Platform
plotlines-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 158.0 kB

Release files / plotlines-0.5.0.tar.gz

Download URL plotlines-0.5.0.tar.gz
Size 72.2 kB
Tags Source
SHA-256 checksum
How to use checksums
731f3c83a74ca1059d9f3735f553af95bb1302dd5a91d3abc868562be7007211
BLAKE2b-256 checksum
How to use checksums
eef92635e728e27ec63f56dfa4b056acc8d1a6b182949a01f518945b3615d73b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / plotlines-0.5.0-py3-none-any.whl

Download URL plotlines-0.5.0-py3-none-any.whl
Size 85.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c0e46369391c0b136d41cd63b1c87071284be6bbd7b81887cf052c83b7349a50
BLAKE2b-256 checksum
How to use checksums
65be205f35f6207ef08aa2f6c15175d772c9ea2f9d53708a944ffa357ba93504
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for plotlines 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page