unauthorized is a library of GUI objects and a handful of objects for working
with streaming and mp3s. The home page for the GPL version is here:
http://puredata.info/community/projects/software/unauthorized
unauthorized has split into two versions because of a change of
licensing. This version, maintained in the pure-data SVN, remains GPLv2
while the original author Yves Degoyon has split off a version with a
non-free license.
To get the new non-free version, download it from its new CVS repository:
export CVSROOT=:pserver:anonymous at giss.tv:/home/cvs
cvs co pidip
cvs co unauthorized
original sources available from http://ydegoyon.free.fr/software.html
Installing
----------
there is no configure scripts, you need to install :
* pd headers in /usr/include ( m_pd.h and g_canvas.h )
* libmp3lame-dev for the mp3 externals
* libspeex-dev for the speex external
* sources of stk in /usr/src/stk for stk externals ( optional )
have fun!
sevy ( ydegoyon@gmail.com )
Copyright 2002 Yves Degoyon
Included Objects
-------------
audience~ : 2-dimensional audience simulation ( also called 2 dollars spatialization !!! )
beatify~ : modulate amplitude of a sound
the idea was borrowed from musicscript,
an excellent sound generation tool.
( http://musicscript.sourceforge.net, author : David Piott )
blinkenlight : a blinken lights films player ( but also a pixel grid )
This object displays blinken lights movies, and lets you handle a
grid of pixels. It is also a "Telecran" !! There is a movies
archive @ http://www.blinkenlights.de/gallery/index.en.html
compressor~ : a compressor of audio signals
cooled : a micro sound editor
This object displays a sound, lets you play a part of it and do
some cut and paste operations.
disto~ : a kind of effect used in pop music, use it elsewhere
the algorithm was taken from Digital Effects (DISTORT3), a guitar
effects software for DOS which rocks, written by Alexey Smoli
http://st.karelia.ru/~smlalx/
exciter : a bang-events sequencer
the need for it sprung out of a talking with Nicolas Lhommet.
filterbank~ : filterbank outputs frequency response for a range of filters
formant~ is a formant synthesis generator external for pd
grid : 2-dimensional control object, ala "kaospad"
mp3amp~ is a MPEG I Layer III (mp3) icecast/shoutcast client for Pure Data
mp3amp~ has been compiled for Linux using LAME 3.92.
The newest version of LAME can be found at sourceforge.net
PLEASE NOTE: This software may contain patented alogrithm (at
least patented in some countries). It may be not allowed to
sell/use products based on this source code in these
countries. Check this out first!
COPYRIGHT of MP3 music: Please note, that the duplicating of
copyrighted music without explicit permission violates the rights
of the owner.
Using mp3amp~ external for Pure Data
Open the help-mp3amp~.pd to understand how it works. Open the
help-graphic-mp3amp~.pd if you want to see the status of the
incoming stream.
BUGS :
a/ certainly, not all bitrates will work,
that's too tedious to test, 128, 256, 320 are ok.
b/ cannot instantiate more than 10 decoders, if needed change
MAX_DECODERS in the code
mp3cast~ is a MPEG I Layer III (mp3) streaming external for pd (by Miller
Puckette) that connects to a SHOUTcast or IceCast server.
Using mp3cast~ external for Pure Data
Open the help-mp3cast~.pd to understand how it works.
In this patch, you must send the messages to mp3cast~
in the following order :
1/ password *****
2/ icecast | mp3cast
3/ connect host port
4/ pd dsp 1
Parameters sent to mp3cast~ object :
Sampling Rate (Hz): Possible values are 48000, 44100 and 32000. If
Pd runs at a different sampling rate, LAME will resample the
signal. Default value for mp3 sampling rate is Pd's sampling rate.
Bitrate (kbit/s): Possible values are 32, 40, 48, 56, 64, 80, 96,
112, 128, 160, 192, 224, 256 and 320. Default is 224.
Mode: Possible values are 0 (stereo), 1 (joint stereo, the
default), 2 (dual channel) and 3 (mono).
Password: The default is 'pd', can be changed with a message
"passwd yourpassword".
Server: Use message "connect name_of_your_server.com port" to
connect (same as with Pd's netsend). 'port' is the number
specified in the server's config file. Attention (for SHOUTcast
users): The actual port number used is one higher! Standard would
be 8000 resulting in a socket at port 8001!!! Bare this in mind
when configuring proxys or using mp3cast~ in connection with
netsend / netreceive. For IceCast, the port number used is the
same as specified.
Outlet: The outlet outputs an int, 1 if connected to SHOUTcast
server, 0 if not. This could be used to build an automatic
reconnect mechanism.
Other things: mp3cast~ prints the current status (connection,
login, LAME status) to the pd window. To see the current settings,
send it a message "print" and mp3 settings will be displayed.
Note that changing any mp3 settings will require to disconnect and
reconnect again! This has to be done manually.
Known problems: If you turn off audio processing when you are
connected with the server, no data will be sent to it. This will
make the server disconnect after a certain time ('no data' error
in server log). mp3cast~ does not recongnise this and attempts to
keep on streaming. To avoid this set 'AutoDumpSourceTime' in the
servers config file to a fairly high value preventing the server
from closing the socket to fast.
ALLOWED QUALITY FACTOR :
-q <arg> <arg> = 0...9. Default -q 5
-q 0: Highest quality, very slow
-q 9: Poor quality, but fast
-h Same as -q 2. Recommended.
-f Same as -q 7. Fast, ok quality
ALLOWED SAMPLERATE/BITRATES
MPEG-1 layer III sample frequencies (kHz): 32 48 44.1
bitrates (kbps): 32 40 48 56 64 80 96 112 128 160 192 224 256 320
MPEG-2 layer III sample frequencies (kHz): 16 24 22.05
bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160
MPEG-2.5 layer III sample frequencies (kHz): 8 12 11.025
bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160
mp3live~ is a peer-to-peer mp3 streamer package consisting of three
objects : mp3streamout~, mp3fileout~ and mp3streamin~.
using mp3live~ external for Pure Data
Open the mp3live~-help.pd to understand how it works.
A note about MPEG encoding :
ALLOWED QUALITY FACTOR :
-q <arg> <arg> = 0...9. Default -q 5
-q 0: Highest quality, very slow
-q 9: Poor quality, but fast
-h Same as -q 2. Recommended.
-f Same as -q 7. Fast, ok quality
ALLOWED BITRATES :
bitrates (kbps): 32 40 48 56 64 80 96 112 128 160 192 224 256 320
BUGS :
1. You cannot create more than MAX_DECODERS mp3streamin~
objects. The actual value is 100.
2. Current version of lame ( 3.92 ) produces a lot of errors for
quality < 5. Blame it on lame !!!!
3. Mono is not supported. Some additional code should be added for
mp3streamin~. Blame it on me !!!
4. Resampling is not supported. Blame it on me !!!
mp3write~ is a MPEG I Layer III (mp3) file writer.
using mp3write~ external for Pure Data
Open the help-mp3write~.pd to understand how it works.
In this patch, you must send the messages to mp3write~
in the following order :
1/ append|truncate if you wish to change file creation options ( default is append )
2/ open /my/file
3/ start
5/ pd dsp 1
4/ stop : the tag is written at this stage
Parameters sent to mp3write~ object :
Sampling Rate (Hz): Possible values are 48000, 44100 and 32000. If
Pd runs at a different sampling rate, LAME will resample the
signal. Default value for mp3 sampling rate is Pd's sampling rate.
Bitrate (kbit/s): Possible values are 32, 40, 48, 56, 64, 80, 96,
112, 128, 160, 192, 224, 256 and 320. Default is 224.
Mode: Possible values are 0 (stereo), 1 (joint stereo, the
default), 2 (dual channel) and 3 (mono).
Outlet: The outlet outputs an int, which the number of bytes
written in this session. this might be different from file size
if you're using append mode.
Known Problems : All combinations of samplerate, bitrate, quality
factor will not be accepted.
ALLOWED QUALITY FACTOR :
-q <arg> <arg> = 0...9. Default -q 5
-q 0: Highest quality, very slow
-q 9: Poor quality, but fast
-h Same as -q 2. Recommended.
-f Same as -q 7. Fast, ok quality
ALLOWED SAMPLERATE/BITRATES
MPEG-1 layer III sample frequencies (kHz): 32 48 44.1
bitrates (kbps): 32 40 48 56 64 80 96 112 128 160 192 224 256 320
MPEG-2 layer III sample frequencies (kHz): 16 24 22.05
bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160
MPEG-2.5 layer III sample frequencies (kHz): 8 12 11.025
bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160
Furthermore, it seems that high quality factors will not work with
this release of lame ( 3.92 ). The same errors can be obtained
with the command line : lame -q 1 file.wav outputs errors and
mp3write can't do better.
pianoroll : a graphical sequencer controller
playlist : choose a file in 1 click with space, numeric, characters
you can also send a seek message to select a file automatically.
probalizer : outputs integer values according to a drawn probability curve
samplebox~ : an opaque box to record and playback a sound ( with speed variations )
scratcher~ : records a sound and, then, let's you scratch it with your mouse.
scrolllist : displays and scrolls a text in a patch window
sonogram~ : displays, plays back and lets you modify a recorded sonogram.
The real and imaginery part of an fft~ is stored in a sonogram~
and, then, you can apply modifications to it or do mouse-based
graphic modifications. The set of modifications provided for now
consists of matrix operations but it will be improved soon.
speex~ is a voice quality streamer using Speex library consisting of
two objects : speexin~ and speexout~. A big thanx to Jean-Marc
Valin, author of Speex who helped me fixing encoding/decoding
problems.
PLEASE NOTE: The speex codec is patent free unlike GSM codecs.
that's the main reason why it's been choosen. ( + it allows very
low throughputs like 8kbits/s ).
spigot~ : a signal router.
vocoder~ : vocoder filter for PD inspired by xvox ( http://simon.morlat.free.fr )
i used xvox version 0.2.1, but you don't need to install it,
everything needed is bundled here.
wahwah~ : a kind of effect used in psychedelic music, use it elsewhere
the algorithm was taken from Digital Effects, a guitar effects
software for DOS which rocks, written by Alexey Smoli (
http://st.karelia.ru/~smlalx/ )
Download Latest Version
Pd-extended_0.43.4-source.tar.bz2 (32.4 MB)
