Skip to content

A GUI tool for creating shot lists for a screenplay by drawing lines. Built using Godot 4.

License

Notifications You must be signed in to change notification settings

richardmrodriguez/ShotLiner

Repository files navigation

ShotLiner

A screenplay lining tool built with Godot 4.2

ShotLiner is a free and open-source tool for creating shotlists from a screenplay PDF.

Current Release: 0.3.2

New in 0.3.x:

  • User Input

    • Abstract user input using Godot input mapping, prepare for touch-screen based input

    • Add basic keyboard shortcuts

      • Ctrl+Z - Undo
      • Ctrl+Shift+Z - Redo
      • Ctrl+I - Import PDF
      • Ctrl+S - Save to ShotLiner (.sl) Document
      • Ctrl+O - Open ShotLiner (.sl) Document
      • Ctrl+E - Export to CSV
    • Shotline Control Change

      • Hold Alt while drawing to invert filmed segments of shotlines, instead of right click
  • 0.3.1 - Hotfix:

    • Fixed bug that caused file dialog to no longer show up after completing a single file open or close operation
  • 0.3.2 - Bugfix

    • Commented out a debug line that caused scene numbers to be overwritten by placeholder text

I am currently developing this solo, and would greatly appreciate any and all feedback. Please open a GitHub issue, or send me an e-mail for a feature request or bug report:

[email protected]

Please include the following information, if filing a bug report:

  • Platform (Windows, Mac, Linux, etc.)
  • Hardware (Computer Model number, or a detailed list of components)
  • ShotLiner version
  • Steps to repeat bug or failure (!)

Current Features

  • Import any screenplay-formatted PDF
  • Create multiple ShotLines per page
    • Resize shotline using Move tool
      • Shotlines can be Multipage, and span across many pages
    • A Shotline will have a Closed or Open endcap at each end, to visually distinguish which lines start or end on a previous or following page
    • Click on individual Shotlines to assign unique metadtata
    • delete Shotlines by using eraser tool
    • Click and drag Shotlines to move them horizontally
      • When dragged to a new x-position, Shotlines retain that position when the page is refreshed
    • Right-click drag over the body of a Shotline to toggle filmed (Straight line) or unfilmed (jagged line) segments
  • Save and Load document and shotline data to .sl file
  • Can export shotlines and metadata to a CSV file
  • Use Toolbar to select either Draw, Erase, or Move tool
  • Can Undo and Redo the following:
    • Navigate Pages
    • Draw shotlines
    • Erase Shotlines
    • Toggle Filmed/ unfilmed sections of shotlines (Straight or Jagged lines)
    • Resize shotlines
    • Move shotlines horizontally on page

DEPENDENCIES / ATTRIBUTION

  • PdfPig
    • This Library is used to ingest PDF text content, including the exact position of each character or grapheme on a page
  • godot-uuid

About

A GUI tool for creating shot lists for a screenplay by drawing lines. Built using Godot 4.

Resources

License

Stars

Watchers

Forks

Packages

No packages published