diff --git a/README.md b/README.md index d8fe9ee..86b7516 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,21 @@ eti-tools ========= -ETI conversion software +This is ETI conversion software. The main purpose of this apps - is to convert/manupulate ETI-NA/ETI-NI streams UNIX-way (by using pipelines). With this software you can create your own IceCast2 internet-radio server, which will use your local DAB/DAB+ transmitter as source of the stations streams. You also can re-multiplex some (needed) stations from one ETI-stream to another by using ZeroMQ feature of the ni2http application and ODR-DabMUX. This software also able to receive and convert specially formatted satellite DAB streams to regular DAB-NI, which can be used to feed modulator software/hardware or to create internet-station from that source. Additional libraries are needed: -* [libfec](http://mmbtools.crc.ca/content/view/39/65/) - for Reed-Solomon FEC, may be enabled/disabled. -* [libshout](http://www.icecast.org/download.php) - for NI-to-HTTP converter (used modified one that supports aac and raw streaming). +* [libfec](https://github.com/Opendigitalradio/ka9q-fec) - for Reed-Solomon FEC, may be enabled/disabled. +* [libshout](http://www.icecast.org/download.php) - for NI-to-HTTP converter (included in this package library is modified to support aac and raw streaming). * [libzmq](http://zeromq.org) - optional: for ZeroMQ output of NI-to-HTTP converter (possible re-mux of ETI-streams containing DAB/DAB+ streams). Uncomment it in Makefile if this option is needed. ts2na =============== -ts2na - is MPEG-TS to ETI-NA converter. To use this tool, you have to provide pid to use, and optional offset size. +ts2na - is MPEG-TS to ETI-NA converter. To use this tool, you have to provide pid to use, and optional offset size. ts2na_dreambox.c - is special version for Dreambox DM-500S which can be used to tune frontend to specific frequency. On regular PC use [dvbstream](https://www.linuxtv.org/wiki/index.php/Dvbstream) application to dump or send in pipeline needed PID for this application. usage: ./ts2na [-p pid] [-s offset] [-i ] [-o ] -The output stream will be raw pid content. If negative offset is setted, then "pid" field will be used as part of the ETI stream. +The output stream will be raw pid content. If negative offset is setted, then "pid" field will be used as part of the ETI stream. The parameter [-s offset] must be seen in MPEG-TS dump, in most cases that is unused 0xFF at the beginning of the each TS-packet's payload. ETI na2ni =============== @@ -27,14 +27,14 @@ The output stream will be 6144-bytes aligned raw ETI-NI stream. ETI ni2http =============== -ni2http - is ETI-NI to http converter. This tool converts eti-stream to mp2 and relay it to icecast2 server. +ni2http - is ETI-NI to HTTP or ZeroMQ converter. This tool converts eti-stream to mp2/aac and relay it to icecast2 or ODR-DabMUX server. usage: ./ni2http [--list] [--delay] [-i ] [-c ] Use "--list" option to find SID's and station names of the streams inside ETI. The "--delay" option have to be used when you are doing offline-relaying (from the file, not from the stream). So in that case application will wait 24ms after each eti frame, to make pseudo-realtime streaming. -The application also parses FIC for auto-detecting of station name and X-PAD of DAB and DAB+ for setting current song titles. +The application also able to parse FIC for auto-detecting of station name and X-PAD of DAB and DAB+ for setting current DLS (song titles). Config sample: @@ -78,4 +78,8 @@ Config sample: zmq: tcp://127.0.0.1:9001 In [server] section the parameters of Icecast2 server must be setted. -In [channel] sections at least service-id of the channel must be presented. If u wish to write stream to file, then use "file" to specify it's location. If stream to Icecast2 server is needed, then specify mount-point on the icecast server. If you wish to re-stream to ODR-DabMUX then set destination of the ZeroMQ URI to muxing server. To get list of service-id's, use "ni2http --list -i " +In [channel] sections at least service-id of the channel must be presented. + +If you wish to write stream to file, then use "file" to specify it's location. If stream to Icecast2 server is needed, then specify mount-point on the icecast server. + +If you wish to re-stream to ODR-DabMUX then set destination of the ZeroMQ URI to muxing server. To get list of service-id's, use "ni2http --list -i "