Comprehensive TeX Archive Network

Direc­tory macros/latex/contrib/songs

                       Songs LaTeX Package Documentation

Table Of Contents:
   I. Overview
   II. Copyright Notice
   III. Manifest
   IV. Installation Instructions
   V. Help & Support

I. Overview

The Songs package is for producing songbooks containing lyrics and chords
(but not sheet music).  Each songs document can produce a lyric-only songbook
for singers, a chorded songbook for musicians, a set of overhead
transparencies, or a set of digital projector slides, all from a single master
document.  It can also automatically generate partial songbooks consisting of
only some songs from the master document in a specified order.  Facilities for
automatic transposition and creation of guitar tablature diagrams are also

II. Copyright Notice

The Songs LaTeX Package is copyright (C) 2017 Kevin W. Hamlen.

It is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later version.

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 GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
Street, Fifth Floor, Boston, MA  02110-1301, USA.

III. Manifest

This software consists of three main components:

1. The LaTeX2e "Songs" style package for creating songbooks, with source
consisting of:
     songs.dtx  (self-documenting source code)
     songs.ins  (installer script for docstrip)
     Makefile   (makefile for generating songs.sty and songs.pdf)

2. The songidx index-generation script:
     songidx/songidx.lua  (Lua source file)
     songidx/*.can        (text data files used by songidx at runtime)

(Please note that the "makeindex" program that comes standard with LaTeX
is NOT a suitable replacement for songidx.)

3. A sample chord book, lyric book, slide book, and transparency book:
     sample/songs.sbd           (song data for all four books)
     sample/chordbook.tex       (chord book LaTeX source)
     sample/lyricbook.tex       (lyric book LaTeX source)
     sample/slidebook.tex       (slide book LaTeX source)
     sample/transparencies.tex  (transparencies LaTeX source)
     sample/Makefile            (GNU makefile for generating all four books)

IV. Installation Instructions

1. The songs/Makefile file generates the songs package (songs.sty) and its
documentation (songs.pdf). If pdflatex and makeindex are both in your path,
you should be able to invoke Make to generate both:

     cd songs

Otherwise you will need to first edit the top three lines of the Makefile
to indicate where pdflatex and makeindex are located on your system. If you
wish to use latex instead of pdflatex you must also change the "TEXOUT"
line to "TEXOUT = dvi".

If desired, copy the resulting songs.sty file to the appropriate place in
your LaTeX tree (usually /usr/local/share/texmf/tex/latex/songs).

     mkdir /usr/local/share/texmf/tex/latex/songs
     cp songs.sty /usr/local/share/texmf/tex/latex/songs

2. The sample books can be compiled using the files in songs/sample.  If
pdflatex is in your path, you should be able to invoke GNU Make to generate
all of them (note that GNU-compatible version of Make is REQUIRED):

     cd ../sample

Otherwise you will need to first edit the top line of the Makefile to
indicate where pdflatex is located on your system. If you wish to use
latex instead of pdflatex you must also change the "TEXOUT" line to
"TEXOUT = dvi".

V. Help & Support

The songs.pdf file contains documentation precompiled from the songs.dtx
source code. For more support, including example songbooks, songbook
editing tools, and self-installing executables for Windows, please refer
to the Songs package homepage at:


Down­load the con­tents of this pack­age in one zip archive (1.3M).

songs – Pro­duce song books for church or fel­low­ship

The pack­age pro­vides a means of pro­duc­ing beau­ti­ful song books for church or fel­low­ship. It of­fers:

  • a very easy chord-en­try syn­tax;
  • mul­ti­ple modes (words-only; words+chords; slides; hand­outs);
  • mea­sure bars;
  • gui­tar tab­la­tures;
  • au­to­matic trans­po­si­tion;
  • scrip­ture quo­ta­tions;
  • mul­ti­ple in­dexes (sorted by ti­tle, au­thor, im­por­tant lyrics, or scrip­ture ref­er­ences); and
  • pro­jec­tor-style out­put gen­er­a­tion, for in­ter­ac­tive use.

A set of ex­am­ple doc­u­ments is pro­vided.

Home pagehttp://songs.source­forge.net
Ver­sion3.0 2017-06-05
Li­cense GNU Gen­eral Public Li­cense, ver­sion 2
Main­tainerKevin W. Hamlen
Con­tained inTeX Live as songs
MiKTeX as songs
Topics chord no­ta­tions, as for song books
type­set­ting mu­sic and re­lated stuff
See also songbook
Guest Book Sitemap Contact Contact Author