Toadflax and py_toadflax

Toadflax is a Linux graphical editor and viewer for abc files built using the GTK toolkit. It uses its own music renderer to display the music.

py_toadflax is also a Linux graphical editor and viewer for abc files but built using tkinter (Python windowing toolkit). It uses abcCairo to render the music.

See the file user_guide.txt for instructions on how to use the programs.

Tabctoabc

Tabctoabc is a command-line abc transposer/reformatter similar to abc2abc. This can be build either for Linux or for Windows. A Makefile Makefile.wine is provided to build the Windows version using wine from a Linux computer.

Tabctoabc Usage

Usage: Tabctoabc <filename> [-s] [-c] [-b] [-r] -R] [-e] [-E]
       [-t X] [-nokeys] [-nokeyf] [-key n] [-L]
       [-f] [-d] [-v] [-V X[,Y,,,]] [-ver]
       [-X n] [-OCC] [-u]
  <filename> can go anywhere provided that it ends in .abc
  -s for new spacing
  -c compact note lengths use / instead of /2
  -b to remove bar checking
  -r to remove repeat checking
  -R to attempt to fix missing repeats
  -e to remove all error reports
  -E to report errors at end of file after all tunes
  -t X to transpose X semitones (X may be negative)
  -nokeys No key signature. Use sharps
  -nokeyf No key signature. Use flats
  -key n Use key signature n (+ for sharps/- for flats)
  -L to insert L: field if missing
  -f Find a key signature that minimizes the accidentals
  -d to notate with doubled note lengths
  -v to notate with halved note lengths
  -V X[,Y...] to output only voices X,Y...
  -ver  prints version number and exits
  -X n renumber the all X: fields as n, n+1, ..
  -OCC interpret +<notes>+ as chords [<notes>]
  -u interpret +<text>+ as a decoration !<text>!

Tcairodraw

Tcairodraw is a command-line program to produce image files, similar to abcCairo, but using the Toadflax drawing engine.

Tcairodraw usage

Tcairodraw [options] <abc file>
  <abc file> may appear anywhere in the list of arguments
  provided that it ends in .abc.
  available options are:
  -s : (for debug) produce summary information of tunes.
  -p : (for debug) output tunes read by preparser.
  -CPNG : produce a PNG file for each tune.
  -CSVG : produce an SVG file for each tune.
  -CPDF : produce a PDF file for each tune.
  -CPS : produce a PS file for each tune.
  -t : create filename from tune title
  -e : suppress error and warning messages
  -OCC : interpret + + as a chord
  -u : interpret + + as a decoration
  -O<filestem> : write to specified file.
  -od <directory> : write output to specified directory.

Dependencies

All programs share code written in C. To built these you will need to install the GNU C compiler gcc and GNU make. You will also need to install

libgtk-3-dev for toadflax

and python3, python3-dev and python3-pip for py_toadflax

Once you have python3-pip installed, you will need to install the tk package for python.

pip install tk

Having installed the dependencies, you should be able to build toadflax from the main directory with make commands.

make toadflax

make py_toadflax

make Tabctoabc

make Tcairodraw

See the file code_notes.txt for fuller instructions on building the code.