Tscripter

This gem edits transcript files. Files must be plaintext (.txt).

• Prepend alternating IDs to spoken lines

• If a line starts with ^, then the speaker is the same as the previous line

  • Example:

  You've changed, Heathcliff...
  [looks to the moon]
  ^ ...and I don't know who you are anymore.
  That's not true!
  

  becomes...

  Cathy: You've changed, Heathcliff...
  [looks to the moon]
  Cathy: ...and I don't know who you are anymore.
  Heathcliff: That's not true!
  

• Replace pattern *i MM:SS (where MM:SS is any timestamp) with inaudible [MM:SS]

  • Example:

  But what if *i 10:05 to the end?
  

  becomes...

  Heathcliff: But what if [inaudible 10:05] to the end?
  

  • Note: Currently only supports MM:SS timestamps, not HH:MM:SS

• Lines that contain only stage directions (text inside [square brackets]) are left intact

• Lines that contain only whitespace are left intact

Input:

Hello there.

Hello to you too.

Lovely night on the moors.
[uncomfortable silence]
This is splendid, don't you agree?
I mean, I would never...
[pause]
^ disagree with you.
But what if *i 45:09 tomorrow?
[turns away] You can't mean that!

Output:

Heathcliff: Hello there.

Cathy: Hello to you too.

Heathcliff: Lovely night on the moors.
[uncomfortable silence]
Cathy: This is splendid, don't you agree?
Heathcliff: I mean, I would never...
[pause]
Heathcliff: disagree with you.
Cathy: But what if [inaudible 45:09] tomorrow?
Heathcliff: [turns away] You can't mean that!

• Accept multiple filenames
• Accept wildcard filenames
• Support HH:MM:SS timestamps

$ gem install tscripter

$ tscripter filename.txt Heathcliff Cathy

Heathcliff and Cathy are the IDs to prepend.

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/ichthala/tscripter.

The gem is available as open source under the terms of the MIT License.