vidi-player.py: add missing newlines in error messages
[vidi-player.git] / README.md
1 vidi-player creates a video timeline starting from a MIDI file.
2
3 The video clips are taken from a "VideoFont" in which each sample clip
4 corresponds to a note. The samples are arranged following the time and value of
5 the notes in the MIDI file.
6
7 vidi-player allows to create more easily videos like these:
8
9 * Lasse Gjertsen - Hyperactive -  https://youtu.be/o9698TqtY4A
10 * Vittorio Saggiomo - Mario Bros Column Chromatography - https://youtu.be/mxi3z2vDV_0
11
12
13 Examples of use
14 ===============
15
16 Create a synthetinc VideoFont:
17
18     $ ./create_test_videofont.py videofont
19
20
21 Play the timeline from a MIDI file using the samples from the VideoFont:
22
23     $ ./vidi-player.py examples/Beyer\ Op.\ 101\ -\ Exercise\ 008.midi videofont
24
25
26 Save the timeline to be edited somewhere else (e.g. in PiTiVi):
27
28     $ ./vidi-player.py examples/Beyer\ Op.\ 101\ -\ Exercise\ 008.midi videofont/ Beyer_008.xges
29
30
31 Render the timeline to a video file:
32
33     $ ges-launch-1.0 --load Beyer_008.xges --outputuri Beyer_008.webm --format="video/webm:video/x-vp8:audio/x-vorbis"
34
35
36 Similar projects
37 ================
38
39 Of course if the idea is cool, chances are that others had it too. :)
40
41 Midi-Vidi
42 ---------
43
44 A similar concept called midi-vidi has been developed by Marcus Fischer:
45
46 * http://unrecnow.com/dust/325-midi-vidi-effect-demo/
47 * https://vimeo.com/8049917
48 * http://www.synthtopia.com/content/2009/12/09/midi-vidi-plugin-lets-you-control-video-via-midi-in-max-for-live/
49 * http://www.maxforlive.com/library/device.php?id=120
50
51 Midi-Vidi is also a very cool name, it sound like the Italian "mi dividi" which
52 means "you divide me".
53
54 VidiBox
55 -------
56
57 An interactive video mashup app:
58
59 * http://www.vidibox.net/
60 * https://twitter.com/vidibox