This file is indexed.

/usr/share/doc/liquidsoap/html/index.html is in liquidsoap 1.1.1-7.1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML \
1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
  <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
  <title>Liquidsoap :: Liquidsoap</title>
  <link href="css/style.css" type="text/css" rel="stylesheet" />
</head>
<body>
<div id="wrapper">
  <div id="header">
    <div id="logo">
      <h1>Liquidsoap</h1>
      <h2>audio stream generation</h2>
    </div>
  <div>
   <ul id="menu">
     <li id="menu-about">
       <a href="index.html">about</a></li>
     <li id="menu-doc-index">
       <a href="documentation.html">documentation</a></li>
     <li id="menu-doc-api">
       <a href="reference.html">API</a></li>
     <li id="menu-doc-snippets">
       <a href="scripts/index.html">snippets</a></li>
     <li id="menu-developers">
       <a href="https://github.com/savonet/liquidsoap/issues">developers</a></li>
   </ul>
  </div>
  </div>
  <div id="content"><div>
  <h3>Liquidsoap</h3>
<p>
Liquidsoap is a powerful tool for building complex audio and video stream generators,
typically targetting internet radios and webtvs. It consists of a simple script language,
which has a first-class notion of source (basically a <em>stream</em>) and
provides elementary source constructors and source compositions
from which you can build the stream generator you want.
This design makes liquidsoap flexible and easily extensible.
</p>
<p>
We believe that liquidsoap is easy to use. For basic purposes, the scripts 
consist of the definition of a tree of sources.
You will quickly <a href="quick_start.html">learn</a>
how natural it is to use liquidsoap in such cases. The good thing is that
when you will want to make your stream more complex,
you will be able to stay in the same framework and keep a maintainable 
configuration.
Of course, using some complex features might require a deeper
understanding of the concepts of <a href="sources.html">source</a> and
<a href="requests.html">request</a> and of our <a href="language.html">scripting language</a>.
</p>
<p>
We discuss below what liquidsoap is and what it is not.
If you already know that and want to get started with liquidsoap,
just jump to the <a href="documentation.html">documentation index</a>.
It guides you through these pages,
starting with the <a href="quick_start.html">quickstart tour</a>.
</p>
<p>
Liquidsoap is an open-source sofware
from the <a href="http://liquidsoap.fm" target="_blank">Savonet</a> project.
</p>
<h3>Features</h3>
<p>
Here are a few things you can easily achieve using Liquidsoap:
</p>
<ul>
<li>
Playing from files, playlists, directories or script playlists (plays the file chosen by an external program).</li>
<li>
Transparent remote file access; easy addition of file resolution protocols.</li>
<li>
Scheduling of many sources, depending on time, priorities, quotas, etc.</li>
<li>
Mixing sources on top others.</li>
<li>
Queuing of user requests; editable queues.</li>
<li>
Sound processing: compression, normalization, echo, soundtouch, etc.</li>
<li>
Speech and sound synthesis.</li>
<li>
<a href="metadata.html">Metadata</a> rewriting and insertion.</li>
<li>
Arbitrary transitions: cross-fade, jingle insertion, custom, etc. The behaviour of the transition can be programmed to depend on metadata and average volume.</li>
<li>
<a href="http_input.html">Input of other streams</a>: useful for switching to a live show. Liquidsoap can relay an HTTP stream but also host it.</li>
<li>
<a href="blank.html">Blank detection</a>.</li>
<li>
Definable event handlers on new tracks, new metadata and excessive blank.</li>
<li>
<a href="cookbook.html#lastfm">Last.fm</a> support: play files, streams, audioscrobbling.</li>
<li>
Multiple outputs in the same instance: you can have several quality settings, use several media or even broadcast several contents from the same instance.</li>
<li>
Output to Icecast/Peercast/Shoutcast (MP3/Ogg) or a local file (WAV/MP3/Ogg/AAC).</li>
<li>
Input/output via Jack, ALSA, OSS and PortAudio. Output via <code>libao</code>.</li>
<li>
<a href="advanced.html">Interactive control</a> of many operators via Telnet or UNIX domain socket, and indirectly using scripts, graphical/web/IRC interfaces.</li>
<li>
<a href="video.html">Video streams</a> generation.</li>
</ul>
<p>
If you need something else, it's highly possible that you can have it &ndash; at least by programming new sources/operators. Send us a mail, we'll be happy to discuss these questions.
</p>
<h3>Non-Features</h3>
<p>
Liquidsoap is a flexible tool for processing audio and video streams, that's all. We have used it for several internet radio projects, and we know that this flexibility is useful. However, an internet radio usually requires more than just an audio stream, and the other components cannot easily be built from basic primitives as we do in liquidsoap for streams. We don't have any magic solution for these, although we sometimes have some nice tools which could be adapted to various uses.
</p>
<p>
Liquidsoap itself doesn't have a nice GUI or any graphical programming 
environment. You'll have to write the script by hand, and the only possible 
interaction with a running liquidsoap is the telnet server. However, we have 
modules for various languages (OCaml, Ruby, Python, Perl) providing high-level 
communication with liquidsoap. And there are at least two graphical 
applications using the Python module for controlling a running liquidsoap:
<code>liguidsoap</code> (distributed with liquidsoap) and <code>soapbox</code> (another project of 
Savonet).
</p>
<p>
Liquidsoap doesn't do any database or website stuff. It won't index your audio files, it won't allow your users to score songs on the web, etc. However, liquidsoap makes the interfacing with other tools easy, since it can call an external application (reading from the database) to get audio tracks, another one (updating last-played information) to notify that some file has been successfully played. The simplest example of this is <a href="bubble.html">bubble</a>, RadioPi also has a more complex system of its own along these lines.
</p>
  </div></div>
  <div>
    <div id="footer"> 2003-2013 Savonet team</div>
  </div>
  </div>
</body></html>