How to Post a Piece

First, be aware that the default license for pieces posted to this Web site is https://creativecommons.org/licenses/by-nc-sa/4.0/. However, you may of course use your own license if you put it at the top of your post.

Before posting anything, you must join this blog, and you must use your real email address and your real name to do so. Your email will not be shared with anyone, but we need it to ensure the security of the site. Users with invalid email addresses, false names, or missing names will simply be deleted.

A single post may contain, in addition to one Csound piece, any number of text paragraphs or media files.

Be Patient

If you try to play a piece and nothing happens, be patient. It may take some time for the server to download the Csound module to your Web browser. If waiting doesn’t help, refresh the post containing the piece and try playing it again.

Regular Text Posts

Members may of course post regular text articles. They should have something to do with Csound.

Soundfiles and Videos

Create a new post, and use the Add Media button in the post editor to upload your soundfile or video file. Many formats are supported but Ogg Vorbis (.ogg) for soundfiles and MP4 (.mp4) for videos are preferred. You can add text for your license, program notes, or whatever.

CSD Files

Members may post Csound pieces in the form of CSD files. Such pieces will run on Csound compiled for WebAssembly right in your Web browser. The piece will open in a new window with Play and Stop buttons as well as a console for Csound messages.

To post a piece, simply create a new post. At the top of the post editor you will see a toolbar with a number of icons. Click on the <> icon to open the code editor. Paste your entire .csd file into the text area, and click on the Add button at the top of the code editor to save your piece. You can also create or edit the code in the code editor.

Please note, the CSD file must be completely self-contained. It must not use #include statements or load samples, soundfonts, and such. It also must use only opcodes supported by the WebAssembly build of Csound.

HTML Files

Members may post Csound pieces in the form of HTML files. Such pieces will run on Csound compiled for WebAssembly in a new window of your Web browser.

To post a piece, simply create a new post. At the top of the post editor you will see a toolbar with a number of icons. Click on the <> icon to open the code editor. Paste your entire .html file into the text area, and click on the Add button at the top of the code editor to save your piece. You can also create or edit the code in the code editor.

Please note, with some exceptions noted below, the HTML file must be completely self-contained. It must not use #include statements or load samples, soundfonts, and such. It also must use only opcodes supported by the WebAssembly build of Csound. The Csound code must be embedded  in the HTML file and the controls for playing the piece also must be included in the HTML file. For an example of such a piece, see Minimal HTML Piece.

To embed Csound in an HTML file, place the following into the <head> element of the HTML:

This must be src="/csound.js", not src="/csound.js". In other words, the csound.js file is located in the root directory of our Web site.

Loading External Scripts

The following resources (among others) are available on the server but must be loaded from these absolute paths:

In addition, you can use scripts and other resources loaded from CDNs.