cucumber-ltd / cucumber-school-subtitles

Subtitles for https://cucumber.io/school

cucumber-school-captions

Generating captions for Cucumber School videos!

Vocabulary

• caption frame - a set of text displayed between a start and end time in a video. Example:

2
00:00:19.712 --> 00:00:23.900
Last time we learned how to use
conversations about concrete examples

Steps

• Upload video as unlisted to Youtube. (YT) Their service should automatically generate a subtitles file.
• Edit YT's file in their interface to correct anything that might be wrong with the auto generated text.
• Update the caption file and then download it in its .srt format.
• Use ffmpeg to combine the caption file with the video
  • Example: ffmpeg -i "Cucumber School - 01x01 - Give Me An Example.mp4" -i "Cucumber School - 01x01 - Give Me An Example.vtt" -metadata:s:s:0 language=eng -c copy -c:s mov_text "Cucumber School - 01x01 - Give Me An Example - Captions.mp4"
• Upload to Google Drive in a subs directory under each lesson's directory
• Success!

Style Guidelines

Some notes taken from a couple different style guidelines and decided on by myself.

• No ending commas or periods
• Prefer to have one caption lead immediately into another where it makes sense. This is meant to make the caption reading experience less jarring and smoother. The start time of one frame should be the same as the frame that precedes it so that there is no 'flashing' as one caption disappears and the next appears. Cases when and when not to do this follow:
  • Sentences that span multiple caption frames must be connected
  • Sentences that are within approximately a half second of one another should also be connected.
• Maximum of 2 lines per caption frame
• Maximum of 45 characters per line, where possible, with preference toward shorter lines
• Minimum of 1 seconds of on screen time for shorter frames if possible
• For commands that are to be input, wrap them in 'single quotes'
• For file names or other things like variables, if they are capitalized in the video, make them capital in the caption.

Status

Captions and videos go through a number of statuses in their life cycle and will be tracked below.

• Creation - This step is performed in YouTube's caption tool, in order to modify their auto-generated captions, fixing incorrect words, timing, and spacing.
• Final - This is the final step for the caption files, meant to ensure that everything is correct. Must be done after all have been finished.
• Complete - 🎉

Video	Language	Creation	Final	Complete
01	Shared	√	√	√
02
	Ruby	√	√	√
	Java	√	√	√
03
	Ruby	√	√	√
	Java	√	√	√
04
	Ruby	√	√	√
	Java	√	√	√
05
	Ruby	√	√	√
	Java	√	√	√
06
	Ruby	√	√	√
	Java	√	√	√
07
	Ruby	√	√	√
	Java	√	√	√
08
	Ruby	√	√	√
	Java	√	√	√
09-10
	Ruby	√	√	√
	Java	√	√	√
11-12
	Ruby	√	√	√
	Java	√	√	√

Embed

Here's what I actually used on Windows. This assumes the ffmpeg executable has been moved to a bin directory in the root of the project. This set up made it easy to swap directory and file names out across different videos.

.\bin\ffmpeg.exe ^
    -i ".\09_10_acceptance_tests_vs_unit_tests\java\Cucumber School - 01x09+10 - Acceptance Tests vs Unit Tests (Java).mp4" ^
    -i ".\09_10_acceptance_tests_vs_unit_tests\java\Cucumber School - 01x09+10 - Acceptance Tests vs Unit Tests (Java).srt" ^
    -c copy -c:s mov_text -metadata:s:s:0 language=eng ^
    ".\09_10_acceptance_tests_vs_unit_tests\java\Cucumber School - 01x09+10 - Acceptance Tests vs Unit Tests (Java) - Subs.mp4"

.\bin\ffmpeg.exe ^
    -i ".\09_10_acceptance_tests_vs_unit_tests\ruby\Cucumber School - 01x09+10 - Acceptance Tests vs Unit Tests (Ruby).mp4" ^
    -i ".\09_10_acceptance_tests_vs_unit_tests\ruby\Cucumber School - 01x09+10 - Acceptance Tests vs Unit Tests (Ruby).srt" ^
    -c copy -c:s mov_text -metadata:s:s:0 language=eng ^
    ".\09_10_acceptance_tests_vs_unit_tests\ruby\Cucumber School - 01x09+10 - Acceptance Tests vs Unit Tests (Ruby) - Subs.mp4"

cucumber-school-subtitles's Issues

Create Impact Vs Risk chart for video 11/12

Section is missing from the recorded audio in the videos and needs to be added.

Licensing

I'm thinking we should put this repo under the cucumber-ltd owner, with (c) Cucumber Ltd, license it as creative commons non-commercial, and make it a public repo.

It feels like that way someone else might potentially take on the work of translating these, and I really see no reason to hide them.

@jaysonesmith @jbpros can you see any reason why that would be a bad idea?

Make sure Ruby and Java use the appropriate casing where applicable (camel, snake, etc)

Both videos reference method names and other items through their videos. This is to make sure that the subs utilize casing that fits with the current language.

Clean up ruby video 02 for any style issues

Ticket as a reminder for future work as I've changed the style guide.

Rename repo to cucumber-school-subtitles

Since what I'm making are technically subtitles, we should name the repo accurately. @mattwynne I need your help on this one since I don't have the perms. :p

Need script for massaging caption frame numbers

Each caption 'frame' is numbered in the webvtt file and through my corrections, the numbers get thrown off. While VLC and Quicktime don't seem to care, in pursuit of outputting a well-done product, this should be fixed.

I used to have one created, but need to redo it as I've lost it.

Revisit video 01 to ensure that it matches style guide.

There have been some changes in the way the style guide dictates caption creation/behavior and video 01 should also be consistent with it.

Revisit ALL videos after initial run

Need to make sure that all videos are consistent across the board after all have been worked on. Things like style, timing, and line length/count will be key to get consistent.

This replaces and expands on #3 & #4

Make references to lesson numbers all numbers, instead of words

Instead of lesson five, subs should use lesson 5

US English -> UK English

Need to make sure the things like behaviour are consistent across all videos. Additionally, things where UK english would use an s instead of a z should be investigated.

Fix Diff sub for plus & minus in 05 Java

Needs to be something like: the expected value still has a minus and the actual value has a plus