summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJaromil <jaromil@dyne.org>2013-06-29 17:41:42 (GMT)
committer Jaromil <jaromil@dyne.org>2013-06-29 17:41:42 (GMT)
commit10684b100428db9a38bc597401604d9a7306767e (patch)
tree46ff3905d4778ab70b62ce54d7b590b3c655654c
parente3efb1e9b72a4dcb8d63f985baa882daba7a82fb (diff)
documentation updatesv1.3
-rw-r--r--AUTHORS4
-rw-r--r--ChangeLog5
-rw-r--r--README158
-rw-r--r--doc/hdsync_manual.org70
4 files changed, 114 insertions, 123 deletions
diff --git a/AUTHORS b/AUTHORS
index 661e6b4..7a56d81 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -1,5 +1,5 @@
-HDSync is copyright (C) 2010-2012 by Denis Roio <jaromil@dyne.org>
+HDSync is copyright (C) 2010-2013 by Denis Roio <jaromil@dyne.org>
HDSync source includes code by:
@@ -16,6 +16,8 @@ benefits by the research and development of the WDLXTV.com community.
Since version 1.2 there is an optional dependency from the
FFMpeg.app.bin kindly provided by RMerlin, to detect video length.
+
+
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
diff --git a/ChangeLog b/ChangeLog
index 51ccc00..ae86219 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+30 June 2013 - 1.3 "Still in Amsterdam"
+ Fixes to make PGM broadcast more stable
+ Updated to 0mq library version 2.2
+ Updated to libpgm 5.2.122
+
31 May 2012 - 1.2 "Time Based Arts"
Fixed very long term playback freeze
Adds optional use of FFMpeg
diff --git a/README b/README
index 934c963..0030d09 100644
--- a/README
+++ b/README
@@ -1,6 +1,6 @@
-: From the tradition of Montevideo / Time Based Arts
-: and for the very last time as Netherlands Media Art Institute
-: we are proudly presenting you:
+: From the tradition of Montevideo / Time Based Arts..
+:
+: .. Dyne.org is proudly presenting you:
:
: ,, ,,
: `7MM `7MM
@@ -11,124 +11,106 @@
: MM MM `Mb MM L. I8 VVV MM MM YM. ,
: .JMML JMML.`Wbmd"MML. M9mmmP' ,V .JMML JMML.YMbmd'
: ,V
-: OOb'ver. 1.2 "Time Based Arts"
+: OOb'
+: ver. 1.3 "Still in Amsterdam"
:
: A network based sync-starter for multi-channel HD Video
-: Written by Denis Roio aka Jaromil, R&D Montevideo/NIMk
-: Website: http://syncstarter.org
+: Written by Denis Roio aka Jaromil
+: http://www.syncstarter.org
+
-The digital video syncstarter software was developed through the past
-years by the Montevideo/NIMk Artlab to provide synced playback of
-multiple high definition videos on multiple screens.
+Many artworks and diverse video setups require real-time synced
+playback of different audio/video materials on multiple screens.
+HDSync is a software that can do that with HD video playback on
+multiple devices.
-In the video art field there are many artworks requiring the real-time
-synced playback of audio/video: HDSync provides such a functionality
-for HD decoders, to sync HD video playback on multiple devices.
+Nevertheless our development survived as free and open source
+software, to benefit the video art community at large while keeping
+the good tradition of art research and development alive.
-As a consequence of cultural funding cuts in the Netherlands, this
-development program is being shut down and the whole institute will be
-closing by the end of the year, after more than 30 years of activity.
-Nevertheless we hope this development will survive as free and open
-source software, hoping it can benefit the video art community at
-large, keeping the Montevideo / Time Based Arts tradition alive.
+ More about HDSync: http://www.syncstarter.org/hdsync
- More about HDSync: http://syncstarter.org/hdsync
+ More syncstarter software: http://www.syncstarter.org
- Browse HDSync source code: http://code.dyne.org/hdsync
+In case you need assistance to setup your own HD sync-starter, you can
+contact us and ask a quote, details on: http://syncstarter.org/service
- More syncstarter software: http://syncstarter.org/software
+ Also simple donations are welcome on http://www.dyne.org/donate
- More info about the Dyne.org software foundry: http://dyne.org
+** Documentation
- Donations welcome (and much needed) on http://dyne.org/donate
+A user manual (PDF) is included in the source distribution (doc/) and
+available online at http://files.dyne.org/hdsync
** Usage and compatibility
HDSync only works on a specific hardware configuration: WD HD Live
-players running B-Rad's WDLXTV firmware, something artists themselves
-can afford for approx 100EUR on the consumer market.
-
-Interesting portability horizons at the moment: AppleTV and Boxee
-devices, as well new WDTV models. But we lack the hardware so if you
-have extra please consider a donation!
-
-Of course HDSync can be compiled for x86 and used to activate
-computers running a UPNP-AV daemon that controls video playback.
-Development could as well go into the direction of implementing a PC
-based syncstarter, but this also depends from the support this project
-will receive in future.
+players are consumer grade devices that most people can afford for
+approx 100EUR on the consumer market.
-At the current stage of development hdsync is consisting only of
-portable C/C++ code that can be easily cross-compiled to ARM, MIPS and
-more embedded platforms. It is rather simple to port it to more
-set-top boxes, but we miss the hardware and the time in order to do
-it.
+To be used with HDSync the WD HD Live boxes need to be running B-Rad's
+WDLXTV firmware, found on http://www.wdlxtv.com (see the HDSync user's
+manual for details on which version works best).
-If you are interested to port this software on an hardware platform
-you possess, please contact us! We can arrange a deal, borrow your
-hardware and settle a development plan. This way you, your company or
-your institution might be able to save significant amounts of money by
-adapting the syncstarter software to an existing infrastructure rather
-than buying new hardware.
+Tips and ideas are shared on our mailinglist,
+let us know your progress and projects!
+https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/syncstarter
-** News for this release
-Watch the video documentation of the Ambarella video wall, giving the
-name to this new release: http://vimeo.com/ambarella/video-wall-redux
+** Interesting facts
-HDSync can synchronise the playback of multiple channels, virtually
-unlimited, now Ambarella sets a new record: 37! :^)
+The record number of synced audio/video channels using HDSync is up to
+37 different channels: the Ambarella video wall
+http://vimeo.com/ambarella/video-wall-redux
-This release consists of a full rewrite of the 0.6 version of HDSync
-in C language, eliminating most of the shell scripted interaction and
-condensing operations into a single process. The latest 1.1 release
-just fixes some bugs, especially when running on a statically
-configured network.
+HDSync can be compiled and used on different hardware: its code is
+written in portable C/C++ that compiles for targets as ARM, MIPS and
+x86 platforms.
-The result of the 1.x rewrite is more stability, no more freezes,
-visibly lower latency of operations, more control over network
-handshake and precise frame synchronization (1 to 3 frame error rate)
-plus we've made the HDSync software easy to port on more platforms.
+The digital video syncstarter software was developed between 2006 and
+2012 in the Montevideo/NIMk Artlab. In 2013, as a consequence of
+cultural funding cuts in the Netherlands, the Artlab has been shut
+down and the whole institute has been closed after 35 years of
+activity. Since then, the development of HDSync is not funded anymore.
+For further development, the Syncstarter project needs your support.
-In short: this software is finally STABLE ;^)
+HDSync makes heavy use of PGM multicast (RFC 3208), which is basically
+UDP traffic, to synchronise multiple units on the same local
+network. In order for it to work, make sure your LAN switch does not
+block UDP multicast: old hubs work best.
-Empirical tests show way better synchronization (close to frame
-precision) and very low margin of error in re-syncing after loops
-(still some de-sync occurs from time to time if using short clips).
+HDSync reaches a fairly precise frame synchronization, down to a
+randomly occurring error rate of 3 frames out of sync, which is hardly
+noticeable in most footage. 1 to 1 frame synchronisation is impossible
+to achieve with our software.
-Please note that now it is necessary to add 5 seconds of black in
-front of the synced videos, in order to avoid an irregular blink at
-the start of every loop.
+It is necessary to add 5 seconds of black in front of any synced
+audio/video footage in order to avoid an irregular blink at the start
+of every loop.
-** Documentation
-
-A user manual is online at http://ftp.dyne.org/hdsync/hdsync_manual.pdf
-
-More documentation is included inside the doc/ directory
** Building from source
-In order to compile HDSync for WDTV you need to use a MIPSEL toolchain
-(like the one provided by Emdebian) and use it to compile this
-software: ./configure --host=mipsel-linux-gnu is the correct target
+In order to compile HDSync for a WDTV you need to use a MIPSEL
+toolchain (for instance the one provided by Emdebian works great) and
+use it to compile this software: ./configure --host=mipsel-linux-gnu
However, ready to use binaries (hdsync.app.bin) are provided on
http://files.dyne.org/hdsync
** Support and warranty
-The purpose of this release is to make the project open source to
-allow collaboration with developers interested: we release HDSync as
-free and open source (GNU GPL v3) in the hope it will be useful, but
-WITHOUT ANY WARRANTY.
-
-Voluntary support is provided by the community of users, please join
-our free mailinglist and let us know your progress and projects
-http://mailinglists.dyne.org/cgi-bin/mailman/listinfo/syncstarter
-archived on http://lists.dyne.org/lurker/list/syncstarter.en.html
-
-In case you need assistance to setup your own HD sync-starter, you can
-contact us and ask a quote, details on http://syncstarter.org/service
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program 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. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>
-** So Long, and Thanks For All the Fish!
diff --git a/doc/hdsync_manual.org b/doc/hdsync_manual.org
index 104d95c..661a597 100644
--- a/doc/hdsync_manual.org
+++ b/doc/hdsync_manual.org
@@ -1,6 +1,6 @@
#+TITLE: HDSync Setup Manual
#+AUTHOR: Denis Roio <jaromil@dyne.org>
-#+DATE: Version 1.2, May 2012
+#+DATE: Version 1.3, June 2013
#+LATEX_CLASS_OPTIONS: [a4paper,twocolumn]
@@ -29,7 +29,7 @@ for HD decoders, to sync HD video playback on multiple devices.
The website were to download the latest version of this software, its
sourcecode and this manual, get updates and more informations is:
-http://syncstarter.org
+http://www.syncstarter.org
If you intend to use HDSync. first of all be sure to read and
understand the informations on the [[http://www.wdlxtv.com][WDLXTV]] website. To run HDSync
@@ -39,7 +39,7 @@ playing.
[[file:images/wdhdtv-front.jpg]]
Be sure you have the *Live* model: the one with a network port on its
-back (Ethernet RJ45)
+back (Ethernet RJ45).
[[file:images/wdhdtv-retro.jpg]]
@@ -164,33 +164,30 @@ the USB sticks. *Happy Hacking*!
* Terms and Conditions
HDSync is Free Software and you can use it, modify it and redistribute
-it as you want, provided you read and agree with all terms of the GNU
-GPL v3 license.
+it as you want, provided you read and agree with all terms of the
+Affero GNU GPL v3 license.
-If you use this software for your own art projects, this doesn't mean
-you need to use the same license we use and you can even sell artworks
-made with it; but you must specify reasonably that you are using:
-
- *HDSync, free and open source software developed by Jaromil in the
- Montevideo/NIMk artlab*.
+If you use our software for your own art projects you can sell or
+distribute your artworks as you like; but you must specify in the
+public documentation of your projects that you are *using free and
+open source software by Dyne.org*. Beware: the lack of such a mention
+is an actual violation of our software license.
* Support
-If you rely on this software and you wish we develop it further, you
-are welcome to express your appreciation :)
+If you rely on this software and you wish we develop it further,
+please don't hesitate to express your appreciation. You can get in
+touch with more people using HDSync via [[https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/syncstarter ][our mailinglist]].
If you need support using HDSync, distributing artworks or producing
-installations with it, you can certainly [[http://syncstarter.org/support][hire our assistance]] after
-several years of experience in the fields of video art, installations
-and wall projections, we are happy to make a living offering
-assistance and development services in the field.
+installations with it, you can [[http://syncstarter.org/service][hire our assistance]].
#+LATEX: \pagebreak
* Authors
-HDSync is copyright (C) 2010-2012
+HDSync is copyright (C) 2010-2013
by Denis Roio <jaromil@dyne.org>
@@ -208,27 +205,32 @@ FFMpeg.app.bin kindly provided by RMerlin, to detect video length.
* Disclaimer
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- This program 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. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <http://www.gnu.org/licenses/>.
-
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as
+ published by the Free Software Foundation, either version 3 of the
+ License, or (at your option) any later version.
+
+ This program 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. See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>
+
#+begin_latex
\linebreak
\vspace{40 mm}
#+end_latex
-[[file:images/nimk-logo-eng.jpg]]
-
-: &
[[file:images/dyne-big.png]]
+
+*Free Software Foundry*
+
+We rely on your support to improve the quality of our software, please
+consider [[http://dyne.org/donate][making a donation]]
+
+If you need assistance with your syncstarter project, you can also
+[[http://syncstarter.org/service][hire our service]].