                         Songwrite 2

    A tablature editor with Python, Timidity and Lilypond.


Songwrite 2 is a tablatures (guitar partitions) editor and player.
Songwrite 2 is entirely written in Python.

See the complete doc in ./doc/en/doc.html
or the French version in ./doc/fr/doc.html

NB: this source tarball does not include the source of the
documentation (in LyX format) ; it can be found in the Subversion
server on the Songwrite 2 website.


--- License ---
Songwrite 2 is Free Software.
It is available under GNU GPL.


--- Requirements ---
 * Python 2.5 (older version should work but have not been tested)

 * EditObj 2 (http://home.gna.org/oomadness/en/editobj/index.html)

 * GTK 2, Cairo, and the corresponding Python binding

 * Timidity and  Timidity instruments, or Playmidi, or  another way to
   play midi file (require for playing tablature; you can still create
   midi file without)

 * Lilypond (tested with Lilypond 2.11.20) for printing.
   (and, obviously, LaTeX, TeX and all the Lilypond requirements!)


--- Installation ---
Untar the tarball.
Then you can immediately run Songwrite 2 by running the ./songwrite2
script.

Songwrite 2 uses Python's DistUtils for installation.
To install Songwrite 2, type (as root):

cd Songwrite2-XXX
python ./setup.py install

NB: You'll get a warning at the end ("warning: install: modules
installed to '/usr/share/'..."); you can safely ignore this warning.

You can now run Songwrite 2 by typing "songwrite2" in a console.

By default, Songwrite 2 is installed in /usr, you can modify the
setup.cfg file if you prefer another location.

------

Mail me for any comment, problem, suggestion or help !


Jiba -- Jean-Baptiste LAMY -- jibalamy@free.fr
                              http://home.gna.org/oomadness/
                              http://home.gna.org/oomadness/en/songwrite/index.html
