The Songs LaTeX pac bookstack
kage
Home Downloads Documents Links Contact

Newest version: 2.9 (released August 2, 2009) - This version features a complete overhaul of the page-building algorithm, giving the user more control over song placement and the option to use an external page-building package like multicol if desired. See the release notes for more details.


 bookstack

Windows Downloads

To use the Songs software on Windows, you will first need to download and install three other free software packages if you don't already have them:

  • Download and install MiKTeX. (Any version or package size is sufficient.)

  • Download and install the Vim file editor program.

  • Download and install Adobe Acrobat Reader if you don't already have any software that can read and print PDF files.

Once you've done that, download and run the Windows self-installing executable:


Unix Downloads

On Unix, the songs software is provided as a .tar.gz archive containing LaTeX2e source files, C source code (with Makefile), and Vim script files. To compile the software, you will need:

  • an implementation of LaTeX2e that includes pdflatex. Most Unix installations come with LaTeX2e, but you might need to obtain and install appropriate rpm's if your version lacks pdflatex.

  • a C compiler (every Unix system should already have one)

  • a version of GNU Make (non-GNU versions of "make" are not supported)

  • some means of reading PDF files (e.g. Adobe Acrobat Reader)

  • The Vim file editor is not required but is highly recommended because the songs software includes syntax-highlighting for Vim, which makes song-entry much easier.

Once you have the above, download and unzip the following .tar.gz archive. The top-level README file in the archive contains detailed installation instructions.


Raw Style File

If you don't want to bother with installers, you can download the LaTeX style file directly and manually copy it into an appropriate directory on your system. Without the installer you will not have support for index-generation, Vim syntax-highlighting, or sample documents.


SourceForge Project Page

Alternatively, you can visit the SourceForge project home page and download source code or self-installers from there. You can find it at:

sourceforge.net