kage

Newest version: 3.0 (released June 5, 2017) - After a long steady state, this version updates the songs package to modern LaTeX installations, including a complete port of the indexer to Lua (no more C programs!). It also corrects several longstanding bugs. See the release notes for 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, LuaTeX source code, and Vim script files. To compile the software, you will need:

  • an implementation of LaTeX that includes pdflatex (type "pdflatex --version" at the Unix prompt to see whether you already have it)

  • if you want to auto-generate song indexes, a LaTeX installation that includes LuaTeX (type "texlua --version" at the Unix prompt to see whether you have it)

  • if you want to use make to automate the process of generating the song books, a version of GNU Make (type "gmake --version" at the Unix prompt to see if you already have it)

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

  • if you want an editor program with syntax-hilighting and other automated support for song books, the Vim file editor is highly recommended.

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