explain autobuilds
[xonotic/xonotic.wiki.git] / Music.md
1 Music
2 =====
3
4 Requirements
5 ------------
6
7 -   Vorbis OGG -q4 or above (-q7 or above preferred), or a format good enough for being able to be converted to that (e.g. FLAC, WAV)
8 -   GPL v2 compatible _(for more information see our [legal](legal) page)_
9 -   About 3 to 10 minutes
10 -   Preferably with matching ending and beginning _(so the track loops smoothly)_
11
12 Music Style
13 -----------
14
15 ### Overview
16
17 While we don’t want to tie us to a specific genre, the music must match the visuals of the game. As it is being discussed on [this thread](http://forums.xonotic.org/showthread.php?tid=81) seems that we are about to use a futuristic ambient for the game, so its more than likely that the kind of music that we want will fit within the Electronic genre.
18
19 ### Track Duration
20
21 Currently most contributions come in the format of a regular CD track, that is 3, 4 or 5 minutes long. This is currently an issue because the duration of most matches is about 15-20 minutes, that means that one listens to the very same track many times in row, which is kind of boring. For this reason we would like to have longer tracks, as long as this is possible for artists. However tracks longer than 10 or 15 minutes are not advisable as that will increase dramatically the size of the release package. Note that this is a file size size constraint, not a duration one, tracks that are more easily compressed can have a longer duration.
22
23 ### Matching start and ending
24
25 In spite of having longer tracks its more than likely that a track gets played at two or more times during a match, for this is important that the end and beginning of the track can be matched without disruptions, giving a sense of continuity.
26
27 For this the ideal way is to find a start and end sample index, so that that region is perfectly (clickless) loopable. These can be set as LOOP\_START and LOOP\_END tags in the Vorbis file, and the engine will seek back to LOOP\_START when reaching LOOP\_END. Here's the [thread](http://forums.xonotic.org/showthread.php?tid=359&pid=5602#pid5602) with details, as well as a [video](https://www.youtube.com/watch?v=ZwWZH5cYTCU).
28
29 ### Complexity
30
31 As this game is extremely fast we don’t want to have overly complex tracks at the point of being distracting or that one can’t even understand while playing (e.g. a mad breakbeat tune)
32
33 ### Variations
34
35 Furthermore this game is based a lot on listening, as a way to know if a shot hit or not, or if there is someone nearby picking up items, etc. For this reason we want to avoid abrupt variations in the volume of tracks and/or the abuse of very high pitched sounds.
36
37 ### Suggested Genres
38
39 Electronica, Drum and Bass, House, Jungle, 8 bit, Fake bit, Techno, Hybrid, Ambient, Experimental
40
41 ### Moods
42
43 -   Wanted
44     -   Intense, Trippy, Energetic, Cerebral, Hypnotic, Playful, Ominous, Ambitious, Fast
45 -   Unwanted
46     -   Dramatic, Complex, Clinical, Visceral
47
48 ### Reference tracks
49
50 Following tracks could be taken as a reference of the style that we want
51
52 [Forgotten Tides](http://www.jamendo.com/en/track/145959)  
53 [Foregone Destruction](http://www.youtube.com/watch?v=yNrI6N2jQCk&feature=related)  
54 [Skyward Fire](http://www.youtube.com/watch?v=2bFUNKg0mzg&feature=related)  
55 [Botpack 9](http://www.youtube.com/watch?v=6gwdsQDwAb8&feature=related)  
56 [Stairs](http://blkrbt.googlepages.com/stairs.ogg)  
57 [Rabble Rouser](http://www.youtube.com/watch?v=ki71pm8yDKI&hd=1)  
58
59 Links
60 -----
61
62 -   Licensing
63     -   Our [Legal](Legal) wiki page
64     -   http://wiki.creativecommons.org/GarageBand
65 -   Tools
66     -   OpenMPT http://www.lpchip.com/modplug
67     -   LMMS http://www.lmms.sourceforge.net
68     -   Ardour http://www.ardour.org
69     -   Rosegarden http://www.rosegardenmusic.com/
70     -   http://linux-sound.org/
71 -   Sound banks
72     -   [The Free Sound Project](http://www.freesound.org/tagsViewSingle.php?id=99)
73     -   http://ccmixter.org/
74     -   http://freepats.zenvoid.org/olpc-sounds/
75         -   http://lopho.org/xonotic/olpc\_sound\_samples\_v2.torrent
76
77 How-To’s
78 --------
79
80 **How to add a sound track to Xonotic?**
81
82 -   Copy the track file to the `data/sound/cdtracks` folder
83 -   Add the name of the track (without the extension) at the end of the cvar `g_cdtracks_remaplist`, on the file `defaultXonotic.cfg`. Count all tracks and remember the position of the added one, this information will be used on the following step.
84 -   Open the file `<name of map>.mapinfo` (on `data/xonotic-maps.pk3dir/maps`) and add a line with the text `cd loop x`. This `x` should be the position of the track within the cvar `g_cdtracks_remaplist`.
85
86 **How to add a sound track to a non official map?**
87
88 -   Copy the track to the folder `sound/cdtracks/` (inside the pk3 file)
89 -   Open the file `<name of map>.mapinfo` and add a line with the text `cd loop <track filename>`
90