/DeeFuzzer

Light and instant media streaming client for web radios and TVs written in Python

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

https://github.com/yomguy/DeeFuzzer/raw/master/doc/img/logo_deefuzzer.png

Version

DeeFuzzer is a light and instant application for streaming audio and video over internet. It is dedicated to communities who need to easily create web radios, web TVs, live multimedia relays or personal home radios, with metadata management and other cool features.

Features

  • Streaming MP3, OGG Vorbis files over Internet
  • Live streaming for any kind of format (WebM compatible)
  • Full metadata encapsulation and management
  • Recursive folders, random or M3U playlists management
  • M3U, RSS and JSON podcast generators for URLs, current tracks and playlists
  • Automagic mountpoint creation based on media subfolders
  • Multiple station streaming with only one config file
  • Auto twitting #nowplaying tracks
  • Auto jingling between tracks
  • OSC controller for a few commands
  • Very light and optimized streaming process
  • Fully written in Python
  • Works with Icecast2, ShoutCast, Stream-m
  • (NEW) Works with MySQL playlists

Because our aim is to get DeeFuzzer as light as possible it is NOT capable of re-encoding or transcoding media files for the moment.

News

0.9.0

  • Python 3.11 compatibility
  • Add microseconds to rec filename
  • Add write_conf method to export config
  • Add version to logging

0.8.3

  • Bufix against libshout 2.4.6
  • Add more examples

0.8.0

  • Compatible with Python 3.7 (only)
  • Update dependencies
  • Update headers against GPL v3 licence

0.7.4

  • Change libmysqlclient-dev for libmariadbclient-dev

0.7.3

  • Add absolute feed_dir for feeds

0.7.2

  • Add MySQL module and connection routine to get the playlist from a database (thanks to doomy23)
  • Prepare the Python3 switch
  • Tested against libshout 2.4.1 and python-shout 0.2.5
  • As been used in relay mode in production for almost 5000+ hours
  • Improve conf YAML format support

0.7.1

  • Bugfix release
  • Fix no metadata for stream-m relaying

0.7

  • Huge refactoring which should be compatible with old setups, but before updating please read the updated example and the following news.
  • Reworked the RSS feed handling to allow JSON output as well and more configuration options (@achbed #27 #28)
  • Add an init.d script to act as a deamon (@achbed)
  • Add stationdefaults preference (apply default settings to all stations) (@achbed #31)
  • Add stationfolder preference (generate stations automatically from a folder structure) (@achbed #31)
  • Add stationconfig preference (load other preference files as stations) (@achbed #31)
  • Add new station.server.appendtype option
  • Add new base_dir parameter to station definition
  • Better thread management (@achbed #36 #37 #38)
  • Improved stability avoiding crashes with automatic station restart methods (@achbed #39 #45)
  • Added option (ignoreerrors) to log and continue when an error occurs during station initialization (@achbed #43)
  • Cleanup, better documentation and good ideas (@ChoiZ #15 #16 #17 #23)
  • Various bugfixes
  • Many thanks to all participants and especially to @achbed for his huge work, efficiency and easy collaboration
  • Enjoy!

0.6.6

  • Update station name (remove ": http://url")
  • Update mountpoint name (remove .mp3 or .ogg)
  • Update metadata (replace " : " by " - " between Artist and Track)
  • Remove "ogg_quality" on mp3 streams

0.6.5

  • Stable WebM live streaming through Stream-m server
  • Read yaml configuration files
  • Read m3u playlist files
  • Minor fixes

Installation

DeeFuzzer has now only been well tested on Linux, but should work on any other platform. You would then need to install libshout3 and liblo libraries for it. On Windows, an install inside Gygwin should work well.

To install it, say on Debian, do:

sudo apt-get install python3-pip python3-dev cython3 python3-liblo \
                 python3-mutagen python3-pycurl python3-yaml \
                 python3-mysqldb libshout3-dev librtmp-dev liblo-dev \
                 libcurl4-openssl-dev libmariadb-dev-compat

Then:

sudo pip3 install deefuzzer

Or to upgrade:

sudo pip3 install -U deefuzzer

If you have some version problems with the installation, please also try in a virtualenv.

As a streaming client, the DeeFuzzer needs a local or remote streaming server like Icecast2 to do something:

sudo apt-get install icecast2

Usage

deefuzzer CONFIGFILE

where CONFIGFILE is the path for a XML or YAML config file. For example:

deefuzzer example/deefuzzer.xml

or:

deefuzzer example/deefuzzer.yaml

To make the deefuzzer act as a deamon, just play it in the background:

deefuzzer example/deefuzzer.yaml &

Note that you must edit the config file with right parameters before playing.

Documentation

Development

Everybody is welcome to participate to the DeeFuzzer project!

We use GitHub to collaborate: https://github.com/yomguy/DeeFuzzer

Clone it, star it and join us!

Authors

License

This software is released under the terms of the GNU GPL v3. as described in the file LICENSE.txt in the source directory or online https://github.com/yomguy/DeeFuzzer/blob/master/LICENSE.txt

Aknowledgements

This work is inspired by the great - C coded - Oddsock's streaming program: Ezstream. Since I needed to patch it in order to modify the playlist (randomize for example) and make external batch tools to create multiple channels, I decided to rewrite it from scratch in python.

Some parts of this work are also taken from another Parisson's project: Telemeta (see http://telemeta.org).