SubToSpeech Documentation

1. Introduction

You don't like to read subtitles text lines while watching a video? Other people don't like that either. If you are a video publisher, or you are just a movie viewer, you can use SubToSpeech to convert subtitles to speech, then add it into your video.

SubToSpeech main screen

2. Common Use Case

The common case is when you have a video and a subtitles file, you can convert your subtitles to speech in 4 simple steps:

  1. Open the video file.
  2. Open the subtitles file.
  3. Select a language.
  4. Click Make button, wait until the making process finished and get your output video.

3. Use subtitles tracks within your videos

If you have a video file that contains a subtitles track likes MP4 or MKV, you can select it from the Subtitles Track combo box without adding a subtitles file.

4. Speech Languages

SubToSpeech uses MacOS Text To Speech engine to convert subtitles to speech. Currently, following languages are supported by MacOS:

Arabic (Saudi Arabia), Chinese (China), Chinese (Hong Kong [China]), Chinese (Taiwan), Czech (Czechia), Danish (Denmark), Dutch (Belgium), Dutch (Netherlands), English (Australia), English (India), English (Ireland), English (Scottish Standard English), English (South Africa), English (United Kingdom), English (United States), Finnish (Finland), French (Canada), French (France), German (Germany), Greek (Greece), Hebrew (Israel), Hindi (India), Hungarian (Hungary), Indonesian (Indonesia), Italian (Italy), Japanese (Japan), Korean (South Korea), Norwegian Bokmål (Norway), Polish (Poland), Portuguese (Brazil), Portuguese (Portugal), Romanian (Romania), Russian (Russia), Slovak (Slovakia), Spanish (Argentina), Spanish (Mexico), Spanish (Spain), Swedish (Sweden), Thai (Thailand), Turkish (Turkey).

5. Advanced Audio Overlay

If you don't like the speech that is generated by Text To Speech engine, you can record your voice, or select any audio files, then add it in order to overlay a subtitles item.

SubToSpeech audio overlay

6. Input Videos

You can select your input video in 4 ways:

  1. Click on Open Video File button from the toolbar.
  2. From SubToSpeech app menu, select File > Open Input Video... menu.
  3. From Finder, drag a video file then drop into the video view of SubToSpeech window
  4. From Findler, right click on a video file, select Open With > SubToSpeech menu.

Video Formats

SubToSpeech supports following video formats: 3g2, 3gp, asf, avi, f4v, flv, m2ts, m4v, mkv, mov, mp4, mpeg, mpg, mts, mxf, ogg, ogv, ts, vob, webm, wma, wmv.

Video Codecs:

SubToSpeech supports following video codecs: alias_pix, amv, apng, asv1, asv2, av1, avrp, avui, ayuv, bmp, cinepak, cljr, dirac, dnxhd, dpx, dvvideo, ffv1, ffvhuff, fits, flashsv, flashsv2, flv1, gif, h261, h263, h263p, h264, hap, hevc, huffyuv, jpeg2000, jpegls, magicyuv, mjpeg, mpeg1video, mpeg2video, mpeg4, msmpeg4v2, msmpeg4v3, msvideo1, pam, pbm, pcx, pgm, pgmyuv, png, ppm, prores, qtrle, r10k, r210, rawvideo, roq, rv10, rv20, sgi, snow, sunrast, svq1, targa, theora, tiff, utvideo, v210, v308, v408, v410, vp8, vp9, webp, wmv1, wmv2, wrapped_avframe, xbm, xface, xwd, y41p, yuv4, zlib, zmbv.

Audio Codecs:

SubToSpeech supports following audio codecs: aac, ac3, adpcm_adx, adpcm_g722, adpcm_g726, adpcm_g726le, adpcm_ima_qt, adpcm_ima_wav, adpcm_ms, adpcm_swf, adpcm_yamaha, alac, amr_nb, amr_wb, aptx, aptx_hd, comfortnoise, dts, eac3, flac, g723_1, ilbc, mlp, mp2, mp3, nellymoser, opus, pcm_alaw, pcm_f32be, pcm_f32le, pcm_f64be, pcm_f64le, pcm_mulaw, pcm_s16be, pcm_s16be_planar, pcm_s16le, pcm_s16le_planar, pcm_s24be, pcm_s24daud, pcm_s24le, pcm_s24le_planar, pcm_s32be, pcm_s32le, pcm_s32le_planar, pcm_s64be, pcm_s64le, pcm_s8, pcm_s8_planar, pcm_u16be, pcm_u16le, pcm_u24be, pcm_u24le, pcm_u32be, pcm_u32le, pcm_u8, pcm_vidc, ra_144, roq_dpcm, s302m, sbc, sonic, speex, truehd, tta, vorbis, wavpack, wmav1, wmav2.

7. Input Subtitles

You can select an input subtitles file in 4 ways:

  1. Click on Open Subtitles File button from the toolbar.
  2. From SubToSpeech app menu, select File > Open Subtitles File... menu.
  3. From Finder, drag a subtitles file then drop into the Subtitles Track box of SubToSpeech window
  4. From Findler, right click on a subtitles file, select Open With > SubToSpeech menu.

Subtitles Formats

SubToSpeech supports following subtitles file formats: ass, srt, ssa, vtt.