freedombone/website/EN/app_icecast.html

284 lines
9.3 KiB
HTML
Raw Normal View History

2017-11-27 13:30:52 +01:00
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
2018-04-12 14:01:49 +02:00
<title></title>
<!-- 2018-04-12 Thu 12:18 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" />
<meta name="description" content="How to use Icecast"
2017-11-27 13:30:52 +01:00
/>
2018-04-12 14:01:49 +02:00
<meta name="keywords" content="freedombone, icecast" />
2017-11-27 13:30:52 +01:00
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
2018-04-12 14:01:49 +02:00
.title { text-align: center; }
2017-11-27 13:30:52 +01:00
.todo { font-family: monospace; color: red; }
2018-04-12 14:01:49 +02:00
.done { color: green; }
2017-11-27 13:30:52 +01:00
.tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
2018-04-12 14:01:49 +02:00
.right { margin-left: auto; margin-right: 0px; text-align: right; }
.left { margin-left: 0px; margin-right: auto; text-align: left; }
.center { margin-left: auto; margin-right: auto; text-align: center; }
2017-11-27 13:30:52 +01:00
.underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; }
pre {
border: 1px solid #ccc;
box-shadow: 3px 3px 3px #eee;
padding: 8pt;
font-family: monospace;
overflow: auto;
margin: 1.2em;
}
pre.src {
position: relative;
overflow: visible;
padding-top: 1.2em;
}
pre.src:before {
display: none;
position: absolute;
background-color: white;
top: -10px;
right: 10px;
padding: 3px;
border: 1px solid black;
}
pre.src:hover:before { display: inline;}
2018-04-12 14:01:49 +02:00
pre.src-sh:before { content: 'sh'; }
pre.src-bash:before { content: 'sh'; }
2017-11-27 13:30:52 +01:00
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
2018-04-12 14:01:49 +02:00
pre.src-R:before { content: 'R'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-java:before { content: 'Java'; }
pre.src-sql:before { content: 'SQL'; }
2017-11-27 13:30:52 +01:00
table { border-collapse:collapse; }
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
2018-04-12 14:01:49 +02:00
th.right { text-align: center; }
th.left { text-align: center; }
th.center { text-align: center; }
td.right { text-align: right; }
td.left { text-align: left; }
td.center { text-align: center; }
2017-11-27 13:30:52 +01:00
dt { font-weight: bold; }
2018-04-12 14:01:49 +02:00
.footpara:nth-child(2) { display: inline; }
.footpara { display: block; }
2017-11-27 13:30:52 +01:00
.footdef { margin-bottom: 1em; }
.figure { padding: 1em; }
.figure p { text-align: center; }
.inlinetask {
padding: 10px;
border: 2px solid gray;
margin: 10px;
background: #ffffcc;
}
#org-div-home-and-up
{ text-align: right; font-size: 70%; white-space: nowrap; }
textarea { overflow-x: auto; }
.linenr { font-size: smaller }
.code-highlighted { background-color: #ffff00; }
.org-info-js_info-navigation { border-style: none; }
#org-info-js_console-label
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
.org-info-js_search-highlight
{ background-color: #ffff00; color: #000000; font-weight: bold; }
/*]]>*/-->
</style>
<link rel="stylesheet" type="text/css" href="freedombone.css" />
<script type="text/javascript">
/*
@licstart The following is the entire license notice for the
JavaScript code in this tag.
2018-04-12 14:01:49 +02:00
Copyright (C) 2012-2013 Free Software Foundation, Inc.
2017-11-27 13:30:52 +01:00
The JavaScript code in this tag is free software: you can
redistribute it and/or modify it under the terms of the GNU
General Public License (GNU GPL) as published by the Free Software
Foundation, either version 3 of the License, or (at your option)
any later version. The code is distributed WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
As additional permission under GNU GPL version 3 section 7, you
may distribute non-source (e.g., minimized or compacted) forms of
that code without the copy of the GNU GPL normally required by
section 4, provided you include this license notice and a URL
through which recipients can access the Corresponding Source.
@licend The above is the entire license notice
for the JavaScript code in this tag.
*/
<!--/*--><![CDATA[/*><!--*/
function CodeHighlightOn(elem, id)
{
var target = document.getElementById(id);
if(null != target) {
elem.cacheClassElem = elem.className;
elem.cacheClassTarget = target.className;
target.className = "code-highlighted";
elem.className = "code-highlighted";
}
}
function CodeHighlightOff(elem, id)
{
var target = document.getElementById(id);
if(elem.cacheClassElem)
elem.className = elem.cacheClassElem;
if(elem.cacheClassTarget)
target.className = elem.cacheClassTarget;
}
/*]]>*///-->
</script>
</head>
<body>
<div id="preamble" class="status">
<a name="top" id="top"></a>
</div>
<div id="content">
2018-04-12 14:01:49 +02:00
<h1 class="title"></h1>
2017-11-27 13:30:52 +01:00
<div class="figure">
2018-04-12 14:01:49 +02:00
<p><img src="images/logo.png" alt="logo.png" width="80%" height="10%" align="center" />
2017-11-27 13:30:52 +01:00
</p>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-1" class="outline-2">
<h2 id="sec-1">Icecast</h2>
<div class="outline-text-2" id="text-1">
2017-11-27 13:30:52 +01:00
<p>
Icecast enables you to run something like an internet radio station. So if you have multiple audio files and want to be able to stream those in sequence from a web site then this can be useful.
</p>
<p>
This system is available only via an onion address, which should mitigate the potential for copyright disputes over streamed content. By default it's only set up to stream to a small number of users so that it doesn't put too much stress on CPU or memory requirements, although you can increase the maximum limit if you have a more powerful system and enough bandwidth.
</p>
2018-04-12 14:01:49 +02:00
</div>
</div>
2017-11-27 13:30:52 +01:00
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-2" class="outline-2">
<h2 id="sec-2">Installation</h2>
<div class="outline-text-2" id="text-2">
2017-11-27 13:30:52 +01:00
<p>
Log into your system with:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
2017-11-27 13:30:52 +01:00
<pre class="src src-bash">ssh myusername@mydomain -p 2222
</pre>
</div>
<p>
2017-11-27 13:43:26 +01:00
Using cursor keys, space bar and Enter key select <b>Administrator controls</b> and type in your password. Select <b>Add/Remove Apps</b> then <b>icecast</b>.
2017-11-27 13:30:52 +01:00
</p>
<p>
If you then go to the <b>About</b> screen you'll see the onion address for Icecast and can navigate to it in a Tor compatible browser.
</p>
</div>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-3" class="outline-2">
<h2 id="sec-3">Adding files to be streamed</h2>
<div class="outline-text-2" id="text-3">
2017-11-27 13:30:52 +01:00
<p>
There are two ways to get files onto the system: either via ssh or via a USB drive. File types can be <b>ogg, ogv, mp3 or mp4</b> format.
</p>
<p>
2017-11-27 13:35:18 +01:00
It may take a while for the files to import, especially on a low power single board computer, since any mp3 or mp4 files will be converted to ogg or ogv. If you want to speed this up then you could do this conversion manually on a laptop with ffmpeg before storing files onto the USB drive or uploading them via ssh.
2017-11-27 13:30:52 +01:00
</p>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-3-1" class="outline-3">
<h3 id="sec-3-1">From a USB drive</h3>
<div class="outline-text-3" id="text-3-1">
2017-11-27 13:30:52 +01:00
<p>
Create a directory on the USB drive named <b>icestream</b> and copy your files into there. Plug the drive into your server.
</p>
<p>
Go to the <b>Administrator control panel</b>, select <b>App settings</b>, then <b>icecast</b>, then <b>Import stream files from USB drive</b>.
</p>
</div>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-3-2" class="outline-3">
<h3 id="sec-3-2">Via ssh</h3>
<div class="outline-text-3" id="text-3-2">
2017-11-27 13:30:52 +01:00
<p>
2017-11-27 13:34:19 +01:00
Make a directory named <b>icestream</b> and copy your files into it. Then copy the directory to your server.
2017-11-27 13:30:52 +01:00
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
2017-11-27 13:30:52 +01:00
<pre class="src src-bash">scp -r -P 2222 icestream myusername@mydomain:/home/myusername
</pre>
</div>
<p>
Log into your server with:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
2017-11-27 13:30:52 +01:00
<pre class="src src-bash">ssh myusername@mydomain -p 2222
</pre>
</div>
<p>
Select <b>Administrator controls</b>, enter your password, then go to <b>App settings</b> followed by <b>icecast</b> and <b>Import stream files</b>. Choose the directory with up and down cursors and space bar to select.
</p>
</div>
</div>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-4" class="outline-2">
<h2 id="sec-4">Access controls</h2>
<div class="outline-text-2" id="text-4">
2017-11-27 13:30:52 +01:00
<p>
By default anyone who happens to find your Icecast onion address can listen to your stream. If you only want it to be available to a few friends or family then you can add an extra login password.
</p>
<p>
Go to the <b>Administrator control panel</b>, select <b>App settings</b>, then <b>icecast</b>, then <b>Enable login for stream users</b>. Take a note of the password and you can give that out to whoever needs access, preferably via an encrypted chat app or sneakernet. If you need to copy and paste then hold the shift key while highlighting the password.
</p>
</div>
</div>
</div>
<div id="postamble" class="status">
<style type="text/css">
.back-to-top {
position: fixed;
bottom: 2em;
right: 0px;
text-decoration: none;
color: #000000;
background-color: rgba(235, 235, 235, 0.80);
font-size: 12px;
padding: 1em;
display: none;
}
.back-to-top:hover {
background-color: rgba(135, 135, 135, 0.50);
}
</style>
<div class="back-to-top">
<a href="#top">Back to top</a> | <a href="mailto:bob@freedombone.net">E-mail me</a>
</div>
</div>
</body>
</html>