forked from gavinbeatty/mkvtomp4
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Gavin Beatty
committed
Nov 25, 2013
1 parent
0668a78
commit b8cfad4
Showing
4 changed files
with
136 additions
and
55 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,109 +1,142 @@ | ||
| .TH MKVTOMP4 1 "December 26, 2012" | ||
| .TH "MKVTOMP4" "1" "November 24, 2013" "" "" | ||
| .SH NAME | ||
| .PP | ||
| mkvtomp4 - convert H.264 mkv files to mp4 files playable on the PS3 | ||
| mkvtomp4 \- convert H.264 mkv files to mp4 files playable on the PS3 | ||
| .SH SYNOPSIS | ||
| .PP | ||
| \f[I]mkvtomp4\f[] [\f[I]OPTIONS\f[]] [--] \f[I]<mkvfile>\f[] | ||
| \f[I]mkvtomp4\f[] [\f[I]OPTIONS\f[]] [\-\-] \f[I]<mkvfile>\f[] | ||
| .PP | ||
| \f[I]mkvtomp4\f[] \f[I]--correct-profile-only\f[] [--] | ||
| \f[I]mkvtomp4\f[] \f[I]\-\-correct\-profile\-only\f[] [\-\-] | ||
| \f[I]<rawh264file>\f[] | ||
| .SH DESCRIPTION | ||
| .PP | ||
| Uses mpeg4ip or GPAC\[aq]s MP4Box, mkvtoolnix and ffmpeg to convert | ||
| troublesome mkv files to mp4. | ||
| The conversion does not re-encode the video and only re-encodes the | ||
| The conversion does not re\-encode the video and only re\-encodes the | ||
| audio if it doesn\[aq]t use AAC codec (one can override this behaviour | ||
| using \f[C]--audio-codec\f[]). | ||
| using \f[C]\-\-audio\-codec\f[]). | ||
| They will be playable on the Sony PS3. | ||
| .PP | ||
| We depend on: \f[I]mkvtoolnix\f[], \f[I]mpeg4ip\f[] or GPAC\[aq]s | ||
| \f[I]MP4Box\f[] for the conversion. | ||
| \f[I]ffmpeg\f[] is optional but required for audio transcoding. | ||
| .SH OPTIONS | ||
| .TP | ||
| .B --use-mp4creator, --use-mp4box | ||
| .B \-\-use\-mp4creator, \-\-use\-mp4box | ||
| Specify which mp4 backend to use. | ||
| mp4creator is the default. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --audio-delay-ms=\f[I]\f[] | ||
| .B \-\-mp4creator=\f[I]<mp4creator>\f[] | ||
| Use <mp4creator> as the mp4creator command. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B \-\-mp4box=\f[I]<mp4box>\f[] | ||
| Use <mp4box> as the mp4box command. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B \-\-mkvinfo=\f[I]<mkvinfo>\f[] | ||
| Use <mkvinfo> as the mkvinfo command. | ||
| .RS | ||
| .RE | ||
| .PP | ||
| \-\-mkvextract=** : Use <mkvextract> as the mkvextract command. | ||
| .PP | ||
| \-\-video\-track=** : Use <video_track> from the mkv file instead of | ||
| trying to parse it. | ||
| .PP | ||
| \-\-audio\-track=** : Use <audio_track> from the mkv file instead of | ||
| trying to parse it. | ||
| .TP | ||
| .B \-\-audio\-delay\-ms=\f[I]<delay_ms>\f[] | ||
| When importing the audio track, delay by \f[C]\\<delay_ms>\f[] | ||
| milliseconds. | ||
| e.g., \f[C]--audio-delay-ms\f[]=\f[C]1000\f[] delays by 1 second. | ||
| e.g., \f[C]\-\-audio\-delay\-ms\f[]=\f[C]1000\f[] delays by 1 second. | ||
| Not supported by mp4creator. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --audio-bitrate=\f[I]<bitrate>\f[] | ||
| .B \-\-audio\-bitrate=\f[I]<bitrate>\f[] | ||
| If/When converting audio, use the given bitrate. | ||
| e.g., \f[C]128\f[]. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --audio-channels=\f[I]<channels>\f[] | ||
| .B \-\-audio\-channels=\f[I]<channels>\f[] | ||
| If/When converting audio, use \f[C]\\<channels>\f[] channels in the | ||
| output. | ||
| e.g., \f[C]5.1\f[]. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --audio-codec=\f[I]<codec>\f[] | ||
| .B \-\-audio\-codec=\f[I]<codec>\f[] | ||
| If/When converting audio, convert to \f[C]\\<codec>\f[]. | ||
| Default is \f[C]libfaac\f[]. | ||
| This should be something supported by \f[I]ffmpeg\f[]. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B -o, --output=\f[I]<outfile>\f[] | ||
| .B \-o, \-\-output=\f[I]<outfile>\f[] | ||
| Put the completed mp4 into \f[C]\\<outfile>\f[]. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --keep-temp-files | ||
| .B \-\-keep\-temp\-files | ||
| Keep all temporary files created while converting. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B -n, --dry-run | ||
| .B \-v, \-\-verbose | ||
| Print info about what is happening. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B \-n, \-\-dry\-run | ||
| Don\[aq]t run any commands, but print them in a shellquoted format that | ||
| can be safely copy-pasted by the user. | ||
| can be safely copy\-pasted by the user. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --stop-before-extract-video | ||
| .B \-\-correct\-profile\-only | ||
| Only correct the profile | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B \-\-stop\-before\-extract\-video | ||
| Exit before extracting video from \f[C]\\<mkvfile>\f[]. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --stop-before-correct-profile | ||
| .B \-\-stop\-before\-correct\-profile | ||
| Exit before correcting profile of raw H.264 stream. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --stop-before-extract-audio | ||
| .B \-\-stop\-before\-extract\-audio | ||
| Exit before extracting audio from \f[C]\\<mkvfile>\f[]. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --stop-before-convert-audio | ||
| .B \-\-stop\-before\-convert\-audio | ||
| Exit before converting audio previously extracted. | ||
| This will stop even if the audio does not need to be converted. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --stop-before-video-mp4 | ||
| .B \-\-stop\-before\-video\-mp4 | ||
| Exit before adding the extracted video to the mp4 container. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --stop-before-hinting-mp4 | ||
| .B \-\-stop\-before\-hinting\-mp4 | ||
| Exit before hinting the mp4 file with the video track. | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B --stop-before-audio-mp4 | ||
| .B \-\-stop\-before\-audio\-mp4 | ||
| Exit before adding the extracted (and possibly converted) audio to the | ||
| mp4 container. | ||
| .RS | ||
|
|
@@ -114,11 +147,6 @@ The Matroska (.mkv) file you wish to convert. | |
| .RS | ||
| .RE | ||
| .TP | ||
| .B --correct-profile-only | ||
| Only correct the profile | ||
| .RS | ||
| .RE | ||
| .TP | ||
| .B \f[C]\\<rawh264file>\f[] | ||
| The raw H.264 stream file that will have its profile corrected for use | ||
| on the PS3. | ||
|
|
@@ -135,7 +163,7 @@ Website: <http://code.google.com/p/mkvtomp4/> | |
| Please report all bugs and wishes to <[email protected]> | ||
| .SH COPYING | ||
| .PP | ||
| mkvtomp4 Copyright (c) 2012 Gavin Beatty, <[email protected]> | ||
| mkvtomp4 Copyright (c) 2012, 2013 Gavin Beatty, <[email protected]> | ||
| .PP | ||
| Permission is hereby granted, free of charge, to any person obtaining a | ||
| copy of this software and associated documentation files (the | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| % MKVTOMP4(1) | ||
| % Gavin Beatty | ||
| % December 26, 2012 | ||
| % November 24, 2013 | ||
|
|
||
| # NAME | ||
|
|
||
|
|
@@ -32,11 +32,23 @@ We depend on: *mkvtoolnix*, *mpeg4ip* or GPAC's *MP4Box* for the conversion. | |
| \--use-mp4creator, \--use-mp4box | ||
| : Specify which mp4 backend to use. mp4creator is the default. | ||
|
|
||
| \--mp4creator=*\<mp4creator> | ||
| : Specific the command/path to execute *mp4creator*. | ||
| \--mp4creator=*\<mp4creator>* | ||
| : Use \<mp4creator> as the mp4creator command. | ||
|
|
||
| \--mp4box=*\<mp4box> | ||
| : Specific the command/path to execute *MP4Box*. | ||
| \--mp4box=*\<mp4box>* | ||
| : Use \<mp4box> as the mp4box command. | ||
|
|
||
| --mkvinfo=*\<mkvinfo>* | ||
| : Use \<mkvinfo> as the mkvinfo command. | ||
|
|
||
| --mkvextract=\*<mkvextract>* | ||
| : Use \<mkvextract> as the mkvextract command. | ||
|
|
||
| --video-track=\*<video_track>* | ||
| : Use \<video_track> from the mkv file instead of trying to parse it. | ||
|
|
||
| --audio-track=\*<audio_track>* | ||
| : Use \<audio_track> from the mkv file instead of trying to parse it. | ||
|
|
||
| \--audio-delay-ms=*\<delay_ms>* | ||
| : When importing the audio track, delay by `\<delay_ms>` milliseconds. | ||
|
|
@@ -59,10 +71,16 @@ We depend on: *mkvtoolnix*, *mpeg4ip* or GPAC's *MP4Box* for the conversion. | |
| \--keep-temp-files | ||
| : Keep all temporary files created while converting. | ||
|
|
||
| -v, --verbose | ||
| : Print info about what is happening. | ||
|
|
||
| -n, \--dry-run | ||
| : Don't run any commands, but print them in a shellquoted format that can be | ||
| safely copy-pasted by the user. | ||
|
|
||
| --correct-profile-only | ||
| : Only correct the profile | ||
|
|
||
| \--stop-before-extract-video | ||
| : Exit before extracting video from `\<mkvfile>`. | ||
|
|
||
|
|
@@ -89,9 +107,6 @@ We depend on: *mkvtoolnix*, *mpeg4ip* or GPAC's *MP4Box* for the conversion. | |
| `\<mkvfile>` | ||
| : The Matroska (.mkv) file you wish to convert. | ||
|
|
||
| --correct-profile-only | ||
| : Only correct the profile | ||
|
|
||
| `\<rawh264file>` | ||
| : The raw H.264 stream file that will have its profile corrected for use on | ||
| the PS3. | ||
|
|
@@ -114,7 +129,7 @@ Please report all bugs and wishes to <[email protected]> | |
|
|
||
| # COPYING | ||
|
|
||
| mkvtomp4 Copyright \(c) 2012 Gavin Beatty, <[email protected]> | ||
| mkvtomp4 Copyright \(c) 2012, 2013 Gavin Beatty, <[email protected]> | ||
|
|
||
| Permission is hereby granted, free of charge, to any person obtaining a copy of | ||
| this software and associated documentation files (the "Software"), to deal in | ||
|
|
||
Oops, something went wrong.