Readme for the flabc source distribution
========================================

flabc
-----

flabc is an editor for abc text files that is based on the
cross platform C++ GUI toolkit FLTK. For converting abc
files to postscript and midi it relies on the additional 
external software abctab2ps and abc2midi.


Requirements
------------

In order to compile flabc from the sources, you need an ANSI C++ 
compiler with STL support. Moreover you need at least FLTK 1.3.x 
from www.fltk.org. For MacOS X you should use the svn version of
FLTK because in FLTK 1.3.3 interaction with the clipboard 
(copy & paste) leads to crashes on MacOS X.

Compilation of flabce has been tested with the following compilers:

  gcc (as shipped with Xcode) on MacOS X
  gcc on Linux
  MingW on Windows


Installation
------------

To install flabc from the source code package,
do the following:

  - unpack the TGZ-archive eg. with "tar xzf"
  - change to the subdirectory "src"
  - to compile the source code, type "make"
  - to build the OSX app bundle type "make osxapp"
    this bundle can be copied anywhere

On Linux, if you have the ESP Package Manager (freely available
from http://www.easysw.com/epm/), you can alternatively create
an RPM (DEB) package with "make rpm" ("make deb") and then install
the created package with "rpm -i ..." ("dpkg -i ...").


Some Hints for Usage and Configuration
--------------------------------------

The main menu is accessible with the "Alt" key on Linux/Win32 and
with the "Ctrl + Alt" key on OSX. Hence the keyboard shortcut for
listening to a tune is "Ctrl + Alt + A, L" on OSX and
"Alt + A, L" on Linux.

On OSX you can drag & drop files on flabc. Alternatively you 
can open an abc file 'bla.abc' from the command line with 
"open -a flabc 'bla.abc'" when you have moced the application
bundle to some standard application directory (eg. $HOME/Applications).

When previewing or listening does not work check whether something
is wrong with the settings under "Options/System Environment".
On OSX the folder Contents/Resources/bin in the application bundle
is added to the search path by flabc automatically. It contains
a helper script "open-xapp" for calling X11 applications from Fink
like gv or ghostview.


Copyright and Where to Get It
-----------------------------

Copyright (c) 2006-2015 by Christoph Dalitz

flabc is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as given 
in the file LICENSE.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
file LICENSE for more details.

