Frequently Asked Questions about CADET

Installation

  1. What operating systems can I use to run CADET?
    CADET has been tested on OS X and Windows (7 and 10). You can also run CADET on Linux: from the command line or from an executable script, run the following two commands:
    • $ cd <path-to-cadet-directory>/cadet-resources
    • $ node cadet-server —dir ~
  2. Why do I need to install Node.js in order to run CADET?
    Node.js provides a local Web server (that is, a Web server that runs on your own computer), which makes it possible for CADET to run without being connected to the Internet.
  3. How can I find and install updates to CADET?
    Please check the CADET user group for update announcements. Before installing an update, always be sure to QUIT all previous instances of CADET in all browsers before installing and running the update: from within CADET, open CADET's File menu and choose Quit. Do not simply quit the browser.

Opening and running CADET

  1. When I try to open CADET on my Mac I get a message that the application cannot be opened because it's from an unidentified developer. What should I do?
    Right-click (or Ctrl+click) on "CADET Mac.command," choose Open from the menu and then choose Open from the dialog. You will only need to do this once. See the instructions for opening an unsigned app for additional information.
  2. Can I run CADET in more than one browser simultaneously?
    Yes. If you do run more than one instance of CADET, though, you should not be playing the same media clip.
  3. Can I run CADET from a terminal window?
    Yes. Open a terminal window and follow these steps.

    • CD into the CADET directory.
    • CD into the cadet-resources directory.
    • Type node cadet-server --dir ~, press Enter and CADET will open.
    Note: Issuing the command --dir ~ causes CADET to open with file browsing rooted in the home directory. If you do not issue --dir ~, then CADET will open with file browsing rooted in the root directory.

Writing and editing captions

  1. I styled some of my captions using colors and different fonts, but these styling features do not appear when I export the captions and play them in a media player. Why not?
    CADET provides a wide range of styling options. However, not all caption formats support all of these styling options: for example, SRT does not support markup for text colors or different font faces. Other formats, such as WebVTT and TTML, do support styling options, but not all media players are capable of correctly interpreting styling markup. So even if you export a TTML file with markup for red text, the target player will only show white text if it doesn't know how to interpret the markup for red text.
  2. My caption styles appear correctly in the caption-editing grid in CADET, but the captions in CADET's media player don’t show the styling. Why is that?
    CADET uses WebVTT to display captions in the player.  While WebVTT supports markup for certain kinds of caption styling, some browsers (such as IE, Edge and Firefox) simply ignore all styling markup that is included in WebVTT files. This is why you will only see styled captions when you are running CADET in a browser that supports the styling markup found in WebVTT. Be assured, however, that the WebVTT files that you export from CADET (as well as other caption formats that support styling markup, such as TTML, QTtext and SAMI) contain the appropriate styling commands, regardless of the browser in which CADET is running.  Whether or not your target player will render those styles depends on the player’s ability to interpret the markup correctly.
  3. Can I position captions somewhere other than at the bottom of my video?
    CADET only positions captions at the bottom of the video. Vertical-placement options will be supported in a future release, however.
  4. Can I change the default display of the captions in CADET's video player?
    Because CADET uses your browser's native video player, the captions in the player might look different from one browser to the next. If you're using Safari or IE, however, you can change the default look of the captions:
    • IE 11: go to Tools > Internet Options > Accessibility > Captions.
    • Edge: go to Windows > Settings > Ease of Access > Closed captions.
    • Safari: go to System Preferences... > Accessibility > Captions.
    Note: All of the styling options that you choose will affect the captions that you see in CADET only, but not in the exported caption file.
  5. In IE, when I type Control-O to open a project, a browser dialog appears with no files in it. What should I do?
    In IE, the Ctrl-O key combination is first trapped by the browser itself, which pops up IE’s "Open URL" dialog. Simply close this dialog (either with the mouse or by hitting the Escape key) and CADET's file-browser dialog will fill up with files. Alternatively, you can just open the File menu and select Open.

Controlling the video player

  1. Can I control the video player in CADET using the keyboard?
    Yes. See the list of keyboard shortcuts for more information.
  2. When I press CTRL+Spacebar to play/pause the video player, my Mac starts speaking to me. How do I fix this?
    Your Mac's Mac's text-to-speech (TTS) function is set to use CTRL+Spacebar to speak selected text. To change this, open System Preferences > Accessibility > Speech. From this window you can either disable the TTS function or reassign the shortcut to another keyboard combination. Learn more about the Mac's TTS capabilities.

Importing files into CADET

  1. What file formats will CADET import?
    CADET will import the following file formats: WebVTT, TTML, SRT, QTtext and plain-text files with the extension ".txt". CADET will not import Word files.
  2. I'm trying to import a file into CADET. I can select the file in the Import File dialog, but the text doesn't get imported into the editor. Why not?
    Make sure that the file you are trying to import has been created as UTF-8 with no BOM (byte order mark). Using an application such as BBEdit, Notepad, TextWrangler, Word, etc., open the file and save it as UTF-8 with no BOM, then try importing the file again.
  3. I've used an automatic-captioning service and the captions are full of errors! Can I import this caption file into CADET and clean it up?
    Yes. Import the auto-generated caption file into CADET (using one of the supported import formats), correct the errors in text and timing, and re-export in the appropriate format for your target video player.

Exporting files from CADET

  1. What file formats will CADET export?
    CADET will export the following file formats: WebVTT, TTML, SRT, QTtext, SAMI and plain-text (.txt) files.
  2. I've exported WebVTT captions and put them in a directory with the video on my computer. When I play the video in Chrome, I don't see any captions. But when I play the video in other browsers, I do see captions. Why?
    Chrome won't play captions locally, but if you transfer the WebVTT file to a server you'll see the captions.