From HaskellWiki
Revision as of 15:40, 12 August 2008 by Lemming (talk | contribs) (turn project titles into links)
Jump to: navigation, search

Haskore is a set of Haskell modules for creating, analysing and manipulating music. Music can be made audible through various back-ends. (See below.) A more recent, but less stable version, is available as Darcs repository at http://darcs.haskell.org/haskore/.



To get an impression how intuitive music composition with Haskore is, see the following example code (runs with revised Haskore):

chords =
    (c 0 qn () =:= e 0 qn () =:= g 0 qn ()) +:+
    (c 0 qn () =:= f 0 qn () =:= a 0 qn ()) +:+
    (d 0 qn () =:= g 0 qn () =:= b 0 qn ())

song =
    MidiMusic.fromMelodyNullAttr MidiMusic.AcousticGrandPiano
       (Music.transpose (-48) (Music.changeTempo 3 chords))

The (=:=) means parallel composition and (+:+) means serial composition of musical objects.


Ideally you can compose a song once in Haskore, and then play it by several back-ends. Practically this is more difficult, since all back-ends have different functionality (otherwise there wouldn't be so many).

These back-ends are currently supported:


  • Notation output (Lilypond, partially done in CAEC, see below).
  • Realtime MIDI


There is no Haskore related mailing list, but Haskore related discussion is very welcome at the Haskell art mailing list.

Getting started


With a bit of hacking Haskore can run on several platforms. In fact most of the hassle is caused by Haskore being not properly split into small packages. In future Haskore should consist of a small core for music composition, analysis and manipulation and separate packages for connecting to various back-ends and separated real-time stuff.


The original Haskore was mainly developed on Windows, whereas the revised version was developed mainly in Linux. So least hassle is currently caused on Linux.


Installation using cabal

Prerequisits: You should be able to fetch a package using darcs and configure/build/install it using cabal.

Step 0. Choose a folder where some haskell packages can be stored.

Step 1. Get the packages. If you have cabal-install installed, you can install some packages

 cabal install midi    # this will also install non-negative, event-list
 cabal install markov-chain

Now install each PACKAGE from (non-negative, event-list, record-access, markov-chain, midi, haskore) manually that is still not installed.

 darcs get http://darcs.haskell.org/PACKAGE

Step 2. Patch Haskore's cabal file: Cabal.patch in order to remove some dependencies that you may not need at start (e.g. SuperCollider support):

 cd haskore
 darcs apply /path/to/cabal.patch

Step 3. Build and install the packages that you got by darcs. For each PACKAGE (in the order of above)

 runhaskell Setup.lhs configure (--prefix=/usr/local --user)
 runhaskell Setup.lhs build
 runhaskell Setup.lhs install



A lot of projects were initiated that use the Haskore framework or something in the spirit of Haskore. This page may help to keep an overview of all projects. All maintainers of Haskore related projects are encouraged to add their project here and keep the references up to date.

AuDi Peter Steffen Course material for Algorithms and Data Structures I - A formula language for music ("Algorithmen und Datenstrukturen I - Eine Formelsprache fuer Musik")
AutoTrack Stefan Ratschan A tool for creating practizing and demo tracks from chord charts. You feed the program with a chord chart, set the desired style (jazz, bossa, etc.), tempo, key etc. and it produces a simple MIDI file containing an according bass and drum track. Includes a lot of examples.
CAEC Matt Munz Computer-Aided Etude Composition in Haskell
Design experiments Henning Thielemann Test of several changes of Haskore's design targetting at more flexibility and consistency
Emile Adam Bermingham Eight-Bar Melody Generation in Haskell. Automatic composition based on two initial bars
Gore Johannes Waldmann Convert a melody description in a string into the Haskore Music data structure. Thus simple melodies can be written much more condensed.
HasChorus Martin Schwenke A set of Haskell modules written on top of Haskore to make it easier to sequence simple, repetitive music
Jazkore Jean-François Paiement A model of melodic jazz improvisation in functional programming
Lilypond back-end Jeffrey R. Lewis A back-end for Haskore to produce Lilypond notation files.
Microtonal music Magnus Jonsson This is not Haskore related, though integration into Haskore would be nice
Polymorphic Temporal Media Paul Hudak An Algebraic Theory of Polymorphic Temporal Media - A generalization of Haskore Music and MDL as well as Fran and FAL animation
T-shirt Fritz Ruehr Haskore T-Shirt featuring the 8 laws of polymorphic temporal media