You can now download, free of charge, KangaSound XML files from this listing page for unrestricted use in your
own projects. Here are some guidance notes:
In order to use a downloaded KangaSound XML file, you will need version 3 or later of Kangas Sound Editor or
Kangas Sound Editor QI installed on your computer.
Download the KangaSound XML .zip file of interest; extract the XML file from the .zip file and note the
location of the extracted XML file.
Next, import the extracted KangaSound XML file into Kangas Sound Editor (QI) by selecting from the menu:
XML > Import.
After selecting the extracted XML file, a dialog entitled XML Import Run-time Parameters
will be shown.
The statistics at the bottom of the dialog tell you what is in the KangaSound XML file, in terms of number of
sequences, tracks, compositions etc.
Before actually importing, click the Preview button. This will predict what will
happen when you actually import without making any changes to the data. If there are errors shown in the
Preview results dialog, you can often resolve them – e.g. by adding a prefix or
suffix if there is a name clash – and then click Preview again to see if the
errors have been resolved.
When you are happy enough with the KangaSound XML file to import it, click the Import
button. This will commence validation and import of the file into Kangas Sound Editor (QI). If errors are
encountered, you will be presented with a dialog that lets you examine them.
When the import has completed successfully, you will need to compute the imported elements in order to
generate .WAV sound files which you can listen to. The best way to do this depends on what you are importing
(remember, you can tell what you are importing from the statistics at the bottom of the
XML Import Run-time Parameters dialog):
Single sequence. Select the imported sequence box in the edit pane, and click the
Multiple sequences. If there are only a few sequence boxes, then you could select and
compute each sequence individually, and then select the track they have been imported into, and then click
the Compute kwik button for the track. If there are many sequences, then an
alternative strategy is to select the track they are in, and either click Compute (to
recompute all sequences in the track) or Compute kwik (to compute just the imported
sequences, and combine with pre-computed sequences elsewhere in the track).
Single track. Select the imported track in the edit pane (a black vertical line should appear),
and click the Compute button. Next, click the Compute stereo
button. You then have a choice of clicking Play or Play stereo
depending on whether you want to listen to the track before or after any stereo factors have been applied.
Multiple tracks. Firstly, apply the procedure for 'Single track' for each track you have
imported. Next, from the menu select Track 0 > Fast compute. This will combine all
computed tracks in the composition into track 0, including the imported tracks (provided that each of the
imported tracks has their Include in track 0 checkbox checked). Finally, from the menu,
select Track 0 > Play to listen to the recomputed composition.
Single composition. Firstly, ensure the imported composition is the current one –
if not, open it from the menu: Composition > Open. Next, show track 0 properties
by selecting from the menu:
Track 0 > Show properties. Finally, in the properties window (bottom left hand
corner), click Compute; and, when computation has finished, click
Multiple compositions. For each composition that you have imported, follow the procedure
for 'Single composition' outlined above.
If you encounter any problems whilst downloading or importing KangaSound XML files, we recommend using the
KangaSound XML forum to get
If you use the KangaSound XML file in your own project and subsequently publish work based upon it, we request
that you give credit to the user who uploaded the file in question, by including a link to this web-page and
mentioning the username of the user who uploaded the file.
Can you also consider, at some stage, uploading KangaSound XML files based on your own work to this web-page?
This would help the KangaSound project to grow – without a sufficient number of uploaders, this project
will always remain small and of limited value.
We are now taking submissions of KangaSound XML files – i.e. ones generated by an XML export from Kangas
Sound Editor (QI) – that are to be listed in various categories on this web page. Here are some
The KangaSound XML file you supply a link to is expected to be contained and compressed inside a .zip file,
and will be uploaded to the KangaSound website when we process your submission. The current maximum size of
zip file that we will accept is 10MB, due to space limitations on the KangaSound website.
If you are unable to supply a link (e.g. because you have no webspace of your own), then you can
email the zip file to Joey. In this case, we ask you to limit the zip
file size to a maximum of 1MB. If you can also supply in your email the details asked for on the form:
Submit your XML file
(except for "XML .zip file URL"), as this will help us to get the listing right.
The KangaSound XML file you supply will be available for others to download, import, customize and use free of
charge in their own Kangas Sound Editor (QI) tracks and compositions; it effectively becomes a very useful
building block. In return for downloading your work, we request downloaders to give credit for any work they
subsequently publish that at some stage involved an import of your KangaSound XML file, by mentioning your
username and including a link to this web page from their own website.
The KangaSound XML file should be a playable one, which means that it should contain at least one sequence,
possibly embedded within a track or composition (not all KangaSound XML files are playable – e.g. they
may contain just graphs or harmonics).
There is no need to supply an audio file. We will generate one from the KangaSound XML file you supply, and
embed a player control for it in your listing entry.
The KangaSound XML file should be a self-contained one. This can be achieved by ensuring that the checkbox
Export dependent entities is checked when exporting to XML.
To help avoid name clashes in the data, we request that you use a prefix when exporting to XML. We suggest
that you use a prefix of 3 to 7 letters or digits, followed by an underscore. This could be an abbreviation
of your username, for example.
Kangas Sound Editor QI allows two entities of the same type whose names are differentiated only by their case;
e.g. two harmonic records may be defined in the same database, one called violin and
the other Violin. Kangas Sound Editor, on the other hand, does not allow this.
To avoid this becoming a problem when collaborating through the XML facility, it is recommended that
Kangas Sound Editor QI users do not differentiate the names of two entities of the same type only by case.
If you encounter any problems whilst exporting or submitting KangaSound XML files, we recommend using the
KangaSound XML forum to get help.
For taking the decision to upload your KangaSound XML file, we would like to thank you profusely for helping
the KangaSound project to grow, and become more useful to roos, joeys and humans alike :-)