[linux-audio-dev] MuSE 0.9 codename "COTURNIX" - out now with documented API!

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 re all, i forward you here the announce as somebody could be interested also in exploring the doxyfied MuSE API, which is getting pretty stable now. see http://muse.dyne.org/codedoc ciao! - ----- Forwarded message from jaromil &lt;jaromil(a)dyne.org&gt; ----- Date: Sat, 17 Apr 2004 20:09:46 +0200 From: jaromil &lt;jaromil(a)dyne.org&gt; To: muse(a)dyne.org annunciazio'! annunciazio'! dyne.org autoproduzioni & the FreakNet Medialab proudly present: __ __ ____ _____ ___ ___ | \/ |_ _/ ___|| ____| / _ \ / _ \ | |\/| | | | \___ \| _| | | | | (_) | | | | | |_| |___) | |___ | |_| |\__, | |_| |_|\__,_|____/|_____| \___(_) /_/ codename "COTURNIX" this is RASTA SOFTWARE, Jah Rastafari Livity bless OUR Freedom! :: the Multiple Streaming Engine :: free software for free radios! since 2001, getting better & better download the sourcecode from: http://muse.dyne.org http://muse.dyne.org http://muse.dyne.org http://muse.dyne.org http://muse.dyne.org This application is being developed in the hope to provide the Free Software community a user friendly tool for network audio streaming, making life easier for indypendent free speech radios wanting to stream via http on icecast servers. MuSE is a software for the mixing, encoding, and network streaming of sound: it can transmit an audio signal by mixing together sound taken from files or also network, recursively remixing more MuSE streams. MuSE can simultaneously mix up to 6 encoded audio bitstreams (from files or network, ogg, mp3, wav and other common sound formats), plus an input signal from microphone. MuSE offers an intuitive interface to be operated in realtime, while it can also run slick from the Unix commandline. _ _ _ ___ __ __ _| |_ __ _| |_( )___ _ _ _____ __ _|__ \ \ V V / ' \/ _` | _|/(_-< | ' \/ -_) V V / /_/ \_/\_/|_||_\__,_|\__| /__/ |_||_\___|\_/\_/ (_) There are a LOT of new things in this version of MuSE: it passed more than a year since the previous release and development never stopped, just kept going on silently. So now we have a lot of new features! Spotlights on the large rewrite of Engine parts, especially the Input and Encoder channels, the tightening of the FIFO Pipe mechanism, many speed improvements and full documentation of the API. There is a revamped GTK-2 interface now featuring drag&drop capability, Language translations and much better Profile and Playlist handling, a new libSnd (wav player) input channel during the hackmeeting, full support of Icecast2 streaming both with OGG and MP3 and yet more CLI flexibility. So as spring is coming is time to throw the peach and say COTURNIX! here are the ChangeLog entries: - - important engine optimization and speed improvements - - new GTK-2 graphical interface with improved usability (nightolo) - - new resampling for ogg/vorbis encoding (the secret rabbit code) - - new libsndfile input channel (pallotron) - - new xml profiles (nightolo) - - full range of login types for different servers - - revamped commandline interface with more switches - - some relevant bugfixes improving overall stability - - rewrite of decoder channels - - GTK-2 GUI localization - - updates and more info in the unix manual page - - doxygen documentation of the engine's API ***** Supported servers: You can use MuSE to stream both MP3 or Ogg/Vorbis sound format to a broadcast server, which means that for doing an online radio you still need to setup yours, or find one that let you stream. Such servers can be seen like antennas which amplify your signal and redistribute it to listeners. there are free software implementations of such technology! the ones supported by MuSE are: - - Icecast2 - http://icecast.org - can stream OGG & MP3 - - Litestream - http://litestream.org - can stream MP3 - - Darwin - http://developer.apple.com/darwin/projects/streaming - - Shoutcast - http://shoutcast.com - non free, runs on win32 ***** Supported players: MuSE streams via http, it doesn't uses multicast technology, nor RTP/RTSP, to have the widest possible range of compatible players. You can listen audio produced by MuSE from almost every personal computer and operating system, using one or more of the following: - - xmms - http://www.xmms.org - for GNU/Linux, *BSD, Sun, etc. - - mpg123 - http://www.mpg123.de - for various UNIX systems - - itunes - http://www.apple.com/itunes - on MacOSX - - zinf - http://www.zinf.org - on GNU/Linux and Win32 - - winamp - http://www.winamp.com - on all Win platforms and even more players: something should be also allready available for handeld devices and embedded systems as well. ***** Internals: MuSE is written in C++ and is a multithreaded application. It reads streams using the included libmpeg library (mp3 format) and it can optionally link the OggVorbis library to read ogg files. For encoding the sound into mp3 or ogg it can link either or both LAME and OggVorbis as shared libraries. MuSE also features a user interface using the GTK+ widget library and a console interface using ncurses. Resampling of any input is done with bicubic interpolation to 44khz stereo format, then channels get mixed together and encoded to the desired quality by the selected codec. Separate threads are running for each decoder, the mixer and the encoders, while the flow is synced thru FIFO pipes which implement mutex locking and avoid well race conditions. All the functionalities of MuSE are quite well exposed thru a reusable API, which in fact was the one used to build the GUIs on top. Documentation for it is available on http://muse.dyne.org/codedoc If you are interested, you are very welcome to build new MuSE interfaces, there are still a lot of unexplored possibilities and this engine can be a realiable backend for radio automation interfaces and more. Get in touch with developers! join the mailinglist on http://lists.dyne.org/muse or peek into irc.freenode.net channel #dyne ***** Libraries: - - LAME (optional) Lame can be installed but is no more needed, in particular libmp3lame and the header lame.h must be properly installed. - - OGG VORBIS (optional) You can compile and install libogg and libvorbis on your machine before compiling MuSE; the configure script will recognize them and include support for decoding and mixing of .ogg files. - - GTK+ (optional) if libgtk and all the related libraries are present, MuSE will compile the GTK+ graphic user interface for interactive use and additional fun. - - NCURSES (optional) if libncurses is present, MuSE will compile a text console interactive interface to be used into ASCII terminals. - - SNDFILE (optional) if libsndfile is present then you'll be able to play uncompressed sound files like wav, aiff, snd, voc, pvf, mat, au, sf etc. ***** Compile and install: - - you can get latest version of lame: (if you already have lame and libmp3lame jump to point 2, after checking that version is >3.89) with 'lame --version' or download it from www.mp3dev.org/mp3 and follow the simple instructions to get installed this wonderful GPL mp3 encoder. - - install libogg and libvorbis: http://www.xiph.org/ogg/vorbis/index.html if you don't install any of the above, MuSE will be a simple player. - - compile: cd MuSE-x.x.x ; ./configure (or try ./configure --help to have listed some compile options) ; make ; make install you can also make a debian package and debian aided compilation with: fakeroot debian/rules binary this command will build debian packages for you! to KNOW MORE go to the website on http://muse.dyne.org ***** Report bugs BUG REPORTING is REALLY APPRECIATED! BUT TAKE CARE TO DO IT WELL: please ALWAYS REPORT the muse --version you are running and possibly run the binary with gdb giving us the backtrace of the error. if you understand the above, please go to http://bugs.dyne.org and submit a BUG!!! ***** AUTHORS MuSE is copyleft (c) 2000-2004 by Denis "jaromil" Rojo MuSE's GTK+ GUI is copyleft (c) 2001-2004 by Antonino "nightolo" Radici MuSE's NCURSES GUI is copyleft (c) 2002-2004 by Luca "rubik" Profico MuSE's first GUI is copyleft (c) 2000-2001 by August Black included resampling algos are copyleft (c) 2002 by Matteo "MoP" Nastasi part of the redistributed code is copyright by the respective authors, please refer to the AUTHORS file and to the supplied sourcecode for further information and to COPYING for the full license. for MuSE's development, the author and mantainer has been supported by PUBLIC VOICE Lab ........ [ http://www.pvl.at ] SERVUS.AT ............... [ http://www.servus.at ] ***** PLEASE DONATE! This whole software was built by autonomous efforts and occasionally supported by non-profit organizations, while the development currently relies on the political believing of MuSE's authors, that there should be such a tool and it should be freely available to people willing to do online radio. If you can afford to donate us some money let us know, we also need new and old working hardware. The main coder is a nomad and has no fixed job, you can help him survive with a small donation via paypal.com to jaromil \@\ dyne.org this would be allready much if most users do! and you can be sure this way MuSE will keep on existing. The MuSE development team is also avaliable to run formation courses about usage, customization and reuse/abuse of free and open source software - it offers as well support and warranty, development of software solutions and consulting. There were a number of workshops allready done around Europe on free and opensource network radio streaming, by the hackers @ dyne.org if you want to organize one you're very welcome to contact us! this way you can also help us develop more free software. THANKS, a thousand flowers will blossom! == DISCLAIMER This source code is free software; you can redistribute it and/or modify it under the terms of the GNU Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This source code is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Please refer to the GNU Public License for more details. You should have received a copy of the GNU Public License along with this source code; if not, write to: Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - ----- End forwarded message ----- - -- jaromil, dyne.org rasta coder, http://rastasoft.org I'd be happy to be kidnapped and join the fight against my own gov't - Jo van der Spek