diff options
Diffstat (limited to 'subsonic-site/src/main/webapp/transcoding.jsp')
| -rw-r--r-- | subsonic-site/src/main/webapp/transcoding.jsp | 92 |
1 files changed, 92 insertions, 0 deletions
diff --git a/subsonic-site/src/main/webapp/transcoding.jsp b/subsonic-site/src/main/webapp/transcoding.jsp new file mode 100644 index 00000000..c526f55c --- /dev/null +++ b/subsonic-site/src/main/webapp/transcoding.jsp @@ -0,0 +1,92 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> +<%! String current = "transcoding"; %> +<%@ include file="header.jsp" %> + +<body> + +<a name="top"/> + +<div id="container"> + <%@ include file="menu.jsp" %> + + <div id="content"> + <div id="main-col"> + <h1>Transcoding</h1> + <p> + Transcoding is the process of converting media from one format to another. Subsonic's transcoding engine allows for streaming of + media that would normally not be streamable, for instance lossless formats. The transcoding is performed on-the-fly and doesn't require any disk usage. + </p> + + <p> + The actual transcoding is done by third-party command line programs which are installed in: + </p> + <p> + <b>Windows</b> <code>c:\subsonic\transcode</code><br/> + <b>Mac</b> <code>/Library/Application Support/Subsonic/transcode</code><br/> + <b>Linux</b> <code>/var/subsonic/transcode</code> + </p> + + <p> + Note that two transcoders can be chained together. Subsonic comes pre-installed with ffmpeg which supports + a huge range of audio and video formats. + </p> + + <h2 class="div">Recommended configuration</h2> + <p> + The recommended settings for audio transcoding is: + </p> + <p> + <b>Step 1</b> <code>ffmpeg -i %s -ab %bk -v 0 -f mp3 -</code><br/> + </p> + + <p> + The recommended settings for video transcoding is: + </p> + <p> + <b>Step 1</b> <code>ffmpeg -ss %o -i %s -async 1 -b %bk -s %wx%h -ar 44100 -ac 2 -v 0 -f flv -vcodec libx264 -preset superfast -threads 0 -</code><br/> + </p> + + <p> + Note that "%s" is substituted with the path of the original file at run-time, and "%b" is substituted with + the max bitrate of the player. "%t", "%a" and "%l" are substituted with the song's title, artist and album. + </p> + + + <h2 class="div">Adding custom transcoders</h2> + <p> + You can add your own custom transcoder given that it fulfills the following requirements: + </p> + <ul class="list"> + <li>It must have a command line interface.</li> + <li>It must be able to send output to stdout.</li> + <li>If used in transcoding step 2 it must be able to read input from stdin.</li> + </ul> + + <h2 class="div">Troubleshooting</h2> + <ul class="list"> + <li>Is the transcoder installed in <code>c:\subsonic\transcode</code> (or <code>/var/subsonic/transcode</code>)?</li> + <li>Is the transcoder activated for your player (in Settings > Players)?</li> + <li>Is the proper file extension added to the list of recognized file types (in Settings > General)?</li> + <li>If it still doesn't work, please check the Subsonic log.</li> + </ul> + + </div> + + <div id="side-col"> + <%@ include file="google-translate.jsp" %> + <%@ include file="donate.jsp" %> + <%@ include file="merchandise.jsp" %> + </div> + + <div class="clear"> + </div> + </div> + <hr/> + <%@ include file="footer.jsp" %> +</div> + + +</body> +</html> |