subrip.1 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. .\" $OpenBSD: subrip.1,v 1.2 2007/01/22 17:43:10 espie Exp $
  2. .\" Public domain
  3. .Dd January 20, 2007
  4. .Dt SUBRIP 1
  5. .Os
  6. .Sh NAME
  7. .Nm subrip
  8. .Nd extract subtitles from dvd
  9. .Sh SYNOPSIS
  10. .Nm
  11. .Op Fl qk
  12. .Op Fl d Ar device
  13. .Op Fl m Ar mencoder-cmd
  14. .Op Fl g Ar gocr-cmd
  15. .Fl s Ar sid
  16. .Op Fl s Ar sid
  17. .Fl t Ar title
  18. .Ar output
  19. .Sh DESCRIPTION
  20. The
  21. .Nm
  22. command
  23. extracts subtitles from a dvd using
  24. .Xr mplayer 1
  25. and passes them to
  26. .Xr gocr 1
  27. for conversion into srt files.
  28. The resulting files are named
  29. .Pa output.srt ,
  30. where a
  31. .Sq %d
  32. in output is replaced with the subtitle stream number
  33. .Ar sid .
  34. .Pp
  35. .Nm
  36. is a simple shell-script that acts as a front-end and can be
  37. customized as needed.
  38. .Pp
  39. The extraction is interactive, as
  40. .Xr gocr 1
  41. often will need some help recognizing some character shapes.
  42. .Pp
  43. The options are as follows:
  44. .Bl -tag -width Flooutput
  45. .It Fl d Ar device
  46. Select dvd device.
  47. Defaults to
  48. .Pa /dev/rcd0c .
  49. .It Fl g Ar gocr-cmd
  50. Add extra arguments to the invocation of
  51. .Xr gocr 1 .
  52. Thanks to bugs in
  53. .Xr getopt 1 ,
  54. one should use several
  55. .Fl g
  56. options to specify an option with arguments.
  57. .It Fl k
  58. Keep temporary files.
  59. .It Fl m Ar mencoder-cmd
  60. Add extra arguments to the invocation of
  61. .Xr mencoder 1 .
  62. Thanks to bugs in
  63. .Xr getopt 1 ,
  64. one should use several
  65. .Fl m
  66. options to specify an option with arguments.
  67. .It Fl q
  68. Quiet mode, do not display
  69. .Xr mencoder 1
  70. progress.
  71. .It Fl s Ar sid
  72. Select subtitle id to copy.
  73. At least one subtitle stream should be selected.
  74. .It Fl t Ar title
  75. Select title to copy.
  76. Mandatory.
  77. .Sh FILES
  78. The directory
  79. .Pa db
  80. is used by
  81. .Xr gocr 1
  82. to store user-supplied information to help in character recognition.
  83. .Pp
  84. .Nm
  85. stores temporary files into a temporary subdirectory of
  86. .Va TMPDIR ,
  87. or of
  88. .Pa /tmp
  89. if
  90. .Va TMPDIR
  91. is not set.
  92. .Sh SEE ALSO
  93. .Xr gocr 1 ,
  94. .Xr mencoder 1 ,
  95. .Xr srttool 1 ,
  96. .Xr sub2pgm 1