Switch to unified view

a/doc/sc2mpd.txt b/doc/sc2mpd.txt
...
...
204
204
205
Under most conditions, WIFI data rates should be more than sufficient to
205
Under most conditions, WIFI data rates should be more than sufficient to
206
transport Songcast streams (a bit over 1 Mbit/S for 48k/24bits, 700 Kbits/S
206
transport Songcast streams (a bit over 1 Mbit/S for 48k/24bits, 700 Kbits/S
207
for 44.1k/16 bits).
207
for 44.1k/16 bits).
208
208
209
However, Songcast is probably best transported over a wired connection. If
210
you are doing this over WIFI and experiencing glitches, the wireless is the
211
first suspect.
212
209
== Building sc2mpd
213
== Building sc2mpd
210
214
211
There are two parts in building *sc2mpd*:
215
There are two parts in building *sc2mpd*:
212
216
213
- Building the Openhome libraries
217
- Building the Openhome libraries
...
...
215
219
216
First download a
220
First download a
217
link:http://www.lesbonscomptes.com/upmpdcli/downloads.html[*sc2mpd*
221
link:http://www.lesbonscomptes.com/upmpdcli/downloads.html[*sc2mpd*
218
release] or clone the *sc2mpd*
222
release] or clone the *sc2mpd*
219
link:http://www.github.com/medoc92/sc2mpd[Github repository]. 
223
link:http://www.github.com/medoc92/sc2mpd[Github repository]. 
224
225
226
=== Building the OpenHome libraries
227
228
Building the Openhome libraries is a bit of a black art for a number of
229
understandable reasons:
230
231
- There are no released distributions for the OpenHome libraries, but
232
  only a number of git repositories for the different components. The state
233
  of the repositories is not completely consistent at all times (there will
234
  be moments when a component will not build with another).
235
- The OpenHome build system is very complicated because it works on
236
  multiple platforms and multiple language bindings.
237
238
The *sc2mpd* source comes with a shell script named _ohbuild.sh_ to help
239
with this. It has several functions:
240
 - Cloning the OpenHome and checking out verified revisions
241
 - Applying a few minor patches to ensure that the build will work in a
242
   simplified environment (e.g. without a c# compiler).
243
 - Creating a tar file of a compact trimmed tree.
244
 - Running the build either from the cloned tree or the tar file.
245
246
The tar functions are mostly useful to help with building packages. For a
247
normal build, the procedure would be as follows:
248
249
    cd sc2mpd
250
    mkdir /my/place/for/openhome
251
    sh ohbuild.sh -b /my/place/for/openhome
252
253
254
=== Building sc2mpd
220
255
221
*sc2mpd* depends on a number of libraries:
256
*sc2mpd* depends on a number of libraries:
222
257
223
- The link:http://www.gnu.org/software/libmicrohttpd/[microhttpd]
258
- The link:http://www.gnu.org/software/libmicrohttpd/[microhttpd]
224
  library. Install the development and runtime packages which are currently
259
  library. Install the development and runtime packages which are currently
...
...
226
  (use _libmicrohttpd_ and _libmicrohttpd-devel_ for Fedora).
261
  (use _libmicrohttpd_ and _libmicrohttpd-devel_ for Fedora).
227
- The link:http://www.mega-nerd.com/SRC/[libsamplerate]
262
- The link:http://www.mega-nerd.com/SRC/[libsamplerate]
228
  library. _libsamplerate0_ on debian-derived systems.
263
  library. _libsamplerate0_ on debian-derived systems.
229
- The *libasound* Alsa interface library (_libasound2_).
264
- The *libasound* Alsa interface library (_libasound2_).
230
265
231
Building the Openhome libraries is a bit of a black art, and the *sc2mpd*
266
Once OpenHome is built and the auxiliary library development packages are
232
source comes with an _ohbuild.sh_ script which will try to clone the
233
Openhome Git repositories and build the libs:
234
235
    cd sc2mpd
236
    mkdir /my/place/for/openhome
237
    sh ohbuild.sh /my/place/for/openhome
238
239
Miscellaneous error messages will be displayed during the build. Hope for
240
the best...
241
242
243
When this is done, build *sc2mpd*, using the following commands inside the
267
installed, build *sc2mpd*, using the following commands inside the
244
_sc2mpd_ directory:
268
_sc2mpd_ directory:
245
269
246
    sh autogen.sh
270
    sh autogen.sh
247
    ./configure --prefix=/usr --with-openhome=/my/place/for/openhome
271
    ./configure --prefix=/usr --with-openhome=/my/place/for/openhome
248
    make
272
    make
...
...
254
though).
278
though).
255
279
256
After restarting *upmpdcli*, it should advertise the _Receiver_ service and
280
After restarting *upmpdcli*, it should advertise the _Receiver_ service and
257
appear in the Songcast Sender menus.
281
appear in the Songcast Sender menus.
258
282
259
== Miscellaneous remarks
260
261
Songcast is probably best transported over a wired connection. If you are
262
doing this over WIFI and experiencing glitches, the wireless is the first
263
suspect.