File: README

package info (click to toggle)
autoradio 3.1-6
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 1,784 kB
  • sloc: python: 10,213; sh: 68; makefile: 16
file content (404 lines) | stat: -rw-r--r-- 13,896 bytes parent folder | download | duplicates (2)
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
= AutoRadio version 2.8.5 =
http://autoradiobc.sourceforge.net/

OVERVIEW
--------

Radio automation software. Simple to use, starting from digital audio
files, manage on-air broadcasting over a radio-station or
web-radio. The main components are:

    * Player (integrated or external Xmms/Audacious): plays all your media
      files and send digital sound to an audio device or audio server
 
    * Scheduler: real time manager for emission of special audio files
      like jingles, spots, playlist and programs; interact with player
      like supervisor User

    * interface: WEB interface to monitor the player and scheduler and
      admin the schedules for the complete control over your station
      format. The web interface allows you to easily publish podcasts
      that conform to the RSS 2.0 and iTunes RSS podcast specifications
      The web interface provide a "full compatible" ogg player.

Developed with Python, Django, Dbus it works in an production enviroment


FEATURES
--------

 * manage ogg, mp3, and other media file format managed by player
 * it's designed as client - server
 * manage playlists, inserting on it jingles, spots and programs
 * programmable rules for schedule and period schedule
 * do not overlap schedules: anticipate, postone or delete
 * player is monitored by web interface
 * spots are grouped and ordered by your preference
 * programs are available for podcasting in a very complete rss feed web interface
 * integrated web player for ogg vorbis that is very compatible with most user's systems
 * can produce a palimpsest and a printable version is available following the the italian law standard
 * integrated daemon system with logging
 * provide enhanced version of dir2ogg.py and mkplaylist.py to manage
   files with music (convert to ogg and make playlist)
 * do not use DataBases to manage music; you can use your preferred application to produce playlists  
 * on line web documentation

REQUIRES
--------

autoradio requires:

python >= 2.7

mutagen
muatgen version >= 1.17
http://code.google.com/p/mutagen/

django
http://www.djangoproject.com/
Suggested Django >= 1.7

configobj
Summary     : Config file reading, writing, and validation
URL         : http://www.voidspace.org.uk/python/configobj.html

gstreamer
Autoradio can use gstreamer 0.10 but is better to use gstreamer 1.0; the installed plugins establish the usable audio formats.

OLD DISTRIBUTIONS
-----------------
Autoradio try to work on very old distribution like fedora 8 with xmms and 
cherrypy2
On not so old distribution try to use audacious version >= 1.5 and cherypy3
python >= 2.5

cherrypy
Summary     : A pythonic, object-oriented web development framework
URL         : http://www.cherrypy.org/
Thera are incompatibility from cherrypy version 2 and 3
but autoradio works well with any version :)

Player (xmms or audacious in alternative):

  for xmms player
    pyxmms
    http://people.via.ecp.fr/~flo/index.en.xhtml

    xmms
    http://www.xmms.org/

  for audacious player version >= 1.5
    dbus-python   D-Bus Python Bindings
    http://www.freedesktop.org/software/dbus/

    audacious
    http://audacious-media-player.org/

the player web server respond on port 8888

In debian/ubuntu distribution you need those packeges: python
python-setuptools, python-django, python-django-extensions, python-configobj, gettext
python-reportlab, audacious, python-mutagen (>=1.17) ,python-cherrypy3
, python-dbus, python-magic

In Fedora distibution you need those pckages: python-mutagen >= 1.17 ,
Django, python-configobj, python-cherrypy, python-reportlab, python-docutils,
python-magic and

pyxmms, xmms
or
dbus-python, audacious >= 1.5


HOW TO INSTALL
--------------

>>>>> Easy way:

You can run autoradio daemon and web server from your root software
distributed directory:

python setup.py build

change your preferred language and other preference in autoradio.cfg 

./autoradioctrl --syncdb
You have to answer to some question to setup database.

./autoradioweb run
This start autoradio webserver on localhost port 8080

control+c to stop it
if all works well you can detach it with
./autoradioweb restart

./autoplayerd run
This start the player daemon and you can listen it if you have a sound card and loaded audio files

control+c to stop it
if all works well you can detach it with
./autoplayerd restart


./autoradiod run
This start daemon autoradiod (that in old distribution can launch xmms/audacious ) 

control+c to stop it
if all works well you can detach it with
./autoradiod restart

./autoplayergui
This start the player GUI; with it you can load audio file/playlists and manage audio player


You have to use a browser (on the same machine) pointing to http://localhost:8080


>>>>> Installed way:

you need access to root administrator user and after:

python setup.py install

choose a normal user to run the daemons and create it and login,
make and go in your preferred user working writable directory

modify /etc/autoradio/autoradio-site.cfg or from the normal user
copy it in your working directory with name autoradio.cfg and modify it
specify your personal settings for installed files
if you want you can set user's global settings coping configuration file in
~/.autoradio.cfg

after from root:

autoradioctrl --syncdb --changeuser
autoradioweb restart

You can run autoradiod and autoplayerd in one host and autoradioweb in
other if you use server Data Base like mysql and specify it and where
autoradiod is running in the autoradio configuration (.cfg) files.
The /usr/share/autoradio of the machine where run autoradioweb will be
accessible read (and write) from machine where run autoradiod.  In
addition to do this you have to have a tcp enabled version of dbus
running autoradiodbusd somewhere.

On machine where you want run autoradiod (the player side), after autoradio
installation, from root user create a new user and set password and activate
interactive login like this:
useradd autoradio
passwd autoradio
usermod -s /bin/bash autoradio

login in autoradio user in a X (graphics) session and:
autoradiod run
or
autoradiod restart

For a pubblic web server do not use django internal web server:

autoradioweb stop

but use apache instead:
https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/
you can find an example configuration file in doc directory:
doc/apache_modwsgi_example.conf

set
SERVE_STATIC=False
in /etc/autoradio-site.cfg

>>>> Pachaged way:

for Fedora Centos and Debian/Ubuntu you have the possibility to install from
pachages in a easy way.

The pachage create the autoradio user for you and set everything in a
standard way for an easy use.

to start everythings from root user (prepend sudo command for Ubuntu):
autoradioctrl --syncdb --changeuser
autoradioweb restart

You can run autoradiod and autoplayerd in one host and autoradioweb
in other if you use server Data Base like mysql and specify it and where
autoradiod is running in the autoradio configuration (.cfg) files.
The /usr/share/autoradio of the machine where run autoradioweb will be 
accessible read (and write) from machine where run autoradiod.

On machine where you want run autoplayerd (the player side), after autoradio
installation, from root user create a new user and if you want activate
interactive login like this:
useradd autoradio
passwd autoradio
usermod -s /bin/bash autoradio

login in autoradio user in a X (graphics) session and:
autoradiod run
or
autoradiod restart

If you want you can activate monit daemon to control autoradio
daemons; an example conf file to add to monit is in:
doc/monit_autoradio_example.conf

For a pubblic web server do not use django internal web server:

autoradioweb stop

and use apache instead:
http://docs.djangoproject.com/en/dev/howto/deployment/modpython/#howto-deployment-modpython
you can find an example configuration file in doc directory:
doc/apache_mod_python_example.conf

set
SERVE_STATIC=False
in /etc/autoradio-site.cfg

HOW IT WORKS
------------

In player's playlist you need a queue of media for a minumun of some
hours and for this you have to program some playlist.  Player cannot
stay stopped or paused (if stopped it will be started, if paused it
stay paused) for a corret work.  When time will be right jingle,
programs and spots will be placed in playlist the first position after
the last file inserted before by autoradiod

HOT TO USE IT
-------------

autoradioctrl provide some administration commands like --sincdb to
inizialite the data base.

autoradioweb or other web serber like apache provide a web interface
to program every thinks you cannot find in configuration files; you
have to run it like a permanent daemon; use a browser pointing it at
the machine and port of the web server (http://localhost:8080 is the
default for autoradioweb).

Run autoplayerd to start to play music. You need an audio card.

You can run autoradiod to start the automation of the player;
autoradiod manage the player with the programmed schedules.  You can
run autoplayerd/autoradiod from the same machine where run
auroradioweb; it use sqlite local file. If you use a database
client/server like mysql you can access the DB from an other machine
but you have to read the media files from all machines involved (with
nfs services).

Where you have an X server you can run autoplayergui to interact with
graphical interface with the player.

Read doc/user_guide.txt or the documentation in the web admin
interface for the features enabled in the autoradio suite.

CONTRIBUTED SOFTWARE
--------------------

module daemon come from http://www.livinglogic.de/Python/index.html
## Copyright 2007-2009 by LivingLogic AG, Bayreuth/Germany.
## Copyright 2007-2009 by Walter D�rwald
## OSI Approved :: MIT License

module mkplaylist come from http://bj.spline.de/mkplaylist-man.html
# Author:        Marc 'BlackJack' Rintsch
# Copyright:     (c) 2004-2009
# Licence:       GPL

module dir2ogg come from http://jak-linux.org/projects/dir2ogg/
# Copyright (C) 2007-2009 Julian Andres Klode <jak@jak-linux.org>
# Copyright (C) 2003-2006 Darren Kirby <d@badcomputer.org>
# Licence:       GPL

django-podcast  http://code.google.com/p/django-podcast/
                https://github.com/jefftriplett/django-podcast
#  Copyright (c) 2008, django-podcast Project Members
#  All rights reserved.
#
#  Redistribution and use in source and binary forms, with or without
#  modification, are permitted provided that the following conditions
#  are met:
#
#    * Redistributions of source code must retain the above copyright
#      notice, this list of conditions and the following disclaimer.
#    * Redistributions in binary form must reproduce the above
#      copyright notice, this list of conditions and the following
#      disclaimer in the documentation and/or other materials provided
#      with the distribution.
#    * Neither the name of the django-podcast Project nor the names of its
#      contributors may be used to endorse or promote products derived
#      from this software without specific prior written permission.
# 
#   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
#   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
#   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
#   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
#   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
#   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
#   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
#   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
#   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
#   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
#   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
#   OF THE POSSIBILITY OF SUCH DAMAGE.

SWFObject v2.2 
  <http://code.google.com/p/swfobject/>
  is released under the MIT License 
  <http://www.opensource.org/licenses/mit-license.php> 

jQuery JavaScript Library v1.4.1
  http://jquery.com/

  Copyright 2010, John Resig
  Dual licensed under the MIT or GPL Version 2 licenses.
  http://jquery.org/license

  Includes Sizzle.js
  http://sizzlejs.com/
  Copyright 2010, The Dojo Foundation
  Released under the MIT, BSD, and GPL Licenses.

  jquery Open Window plugin
  http://plugins.jquery.com/project/open
  GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007

Cortado - a video player java applet
  Copyright (C) 2004 Fluendo S.L.

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

anoggplayer
  http://code.google.com/p/anoggplayer/
  GNU LESSER GENERAL PUBLIC LICENSE

fogg
  http://bazaar.launchpad.net/~arkadini/fogg/trunk
  GNU LESSER GENERAL PUBLIC LICENSE

----------------------------------------------------------------------------

Italiano:

Autoradio � una suite di programmi che partendo da file audio digitali
permette la gestione automatica dell'emissione di una stazione
radiofonica.

queste sono le componenti:

    * Player: partendo da una playlist � in grado di gestire
      differenti formati di audio digitali per poi inviare il suono o
      a una scheda audio o a un server audio

    * Scheduler: gestisce in tempo reale l'emissione di particolari
      file o audio quali i jingles, pubblicit�, playlist e programmi;
      interagisce col player controllandolo e impartendo comandi

    * L'intefaccia utente: utilizzando una interfaccia WEB pemette il
      monitoraggio dello scheduler e del player e permette la
      programmazione del palinsesto. L'interfaccia web permette anche
      di pubblicare facilmente podcasts conforme alle specifiche RSS
      2.0 e iTunes RSS.