aboutsummaryrefslogtreecommitdiff
path: root/subsonic-site/src/main/webapp/transcoding.jsp
diff options
context:
space:
mode:
authorScott Jackson <daneren2005@gmail.com>2012-07-02 21:24:02 -0700
committerScott Jackson <daneren2005@gmail.com>2012-07-02 21:24:02 -0700
commita1a18f77a50804e0127dfa4b0f5240c49c541184 (patch)
tree19a38880afe505beddb5590379a8134d7730a277 /subsonic-site/src/main/webapp/transcoding.jsp
parentb61d787706979e7e20f4c3c4f93c1f129d92273f (diff)
downloaddsub-a1a18f77a50804e0127dfa4b0f5240c49c541184.tar.gz
dsub-a1a18f77a50804e0127dfa4b0f5240c49c541184.tar.bz2
dsub-a1a18f77a50804e0127dfa4b0f5240c49c541184.zip
Initial Commit
Diffstat (limited to 'subsonic-site/src/main/webapp/transcoding.jsp')
-rw-r--r--subsonic-site/src/main/webapp/transcoding.jsp92
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>&nbsp;&nbsp;<code>c:\subsonic\transcode</code><br/>
+ <b>Mac</b>&nbsp;&nbsp;<code>/Library/Application Support/Subsonic/transcode</code><br/>
+ <b>Linux</b>&nbsp;&nbsp;<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>&nbsp;&nbsp;<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>&nbsp;&nbsp;<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 &gt; Players)?</li>
+ <li>Is the proper file extension added to the list of recognized file types (in Settings &gt; 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>