Songsheet Generator Release Notes

Version 2.13 for Microsoft Windows®

Note: the contents of this document apply only to the Microsoft Windows version of Songsheet Generator. For information about the Mac OS® X and Java™ platform versions, please see the Songsheet Generator web site.

System Requirements

This version of Songsheet Generator will run on any computer running Windows 7 or newer. The program requires very little disk space and not too much memory.

Songsheet Generator 2.13

Version 2.13.0; March 2017

New features in this release:

  • Improved the songs and print lists: full type-ahead selection is now supported. Artist and key signature are displayed in new columns in the songs list, and key signature or transposed interval are displayed in a separate column in the print list. Clicking on a column header in the songs list will sort the songs by title, key, or artist.
  • Cleaned up the included songs and edited the author, copyright, and key signature.

Fixes and minor changes:

  • Added support for ‘smart’ single or double quotes in title and footer formatting (‘ ’ “ ”).
  • Fixed the suggested footer format code that includes the date (the code to show the day of the month was incorrect).
  • Fixed keyboard navigation tab order in the Print Options page.
  • Added artist and copyright to the new song template.

Songsheet Generator 2.12

Version 2.12.1; January 2017

New features in this release:

  • Changed the importer to use {artist:} and {copyright:} instead of {comment:} for these values.

Fixes and minor changes:

  • Fixed an issue where the ‘Additional left margin’ value was corrupted, causing the second column of two-column songsheets to print over the top of the first column.
Version 2.12.0; December 2016

New features in this release:

  • Added support for {artist:} and {copyright:} directives, as their usage has become common in other Chordpro software.
  • Added controls to adjust all aspects of title and subtitle printing, including some preset formatting suggestions.
  • Artist and Copyright can be printed in the title, footer and comments using %A and %G formatting codes.
  • Added a help dialog for formatting code reference. This dialog can be opened via the menu bar or from the Print and Full Screen Options pages.
  • Added a ‘Fonts’ sub-menu under the ‘Options’ menu for more convenient font changes.
  • Added instant font size change (for the printer) with control-plus and control-minus keyboard shortcuts.
  • The latest release notes can now be viewed directly within Songsheet Generator.

Songsheet Generator 2.11

Version 2.11.3; December 2016

Fixes and minor changes:

  • Fixed an issue with monitor settings that could cause a crash.
  • The installer has been changed to no longer install on Windows XP (XP support was removed in 2.11.2).
Version 2.11.2; June 2016

Fixes and minor changes:

  • Fixed the accuracy of the first slide shown when using the 'start slideshow from selected song' feature.
  • Windows XP is no longer supported.
Version 2.11.1; June 2016

Fixes and minor changes:

  • Fixed a crash that can occur when saving preferences in certain circumstances.
  • Fixed a song parsing problem that would de-capitalize chord names when defined within a song using an uncommon (but supported) syntax.
Version 2.11.0; January 2016

New features in this release:

  • Footer control codes may now be used in comments ({c:}) and instrumental comments ({gc:}). Any footer formatting control codes may be used in comments, except for the justification codes (%l %c %r) which are ignored. This allows data values to be defined in the song, and printed within the song. The current key signature may also be printed in a comment using the %k format code. (As with footers, use %% to print a percent sign.)

Songsheet Generator 2.10

Version 2.10.4; October 2014

Fixes and minor changes:

  • Solfeggio/solfège (do re mi) key names are now displayed in the "Songs to Print" list and in the Transpose Menu.
  • Printer setup page orientation is now remembered when restarting Songsheet Generator.
Version 2.10.3; October 2014

Fixes and minor changes:

  • Rewrote the save and load options settings. These functions were not working on Windows 7 and newer for users who were not running Songsheet Generator with Administrator privileges.
Version 2.10.2; August 2013

New features in this release:

  • Added the ability to exclude some chord grids from printing. These can be specified in the Chords/Grids Options page, separated by a space; for example: C D E G

Fixes and minor changes:

  • Fixed the scan for songs in subfolders option so that it is saved properly when Songsheet Generator exits.
  • The transition time between slides in Full Screen Presentation is now specified in seconds (fractional seconds are allowed).
Version 2.10.1; March 2013

Fixes and minor changes:

  • Fixed a problem where all built-in ukulele grids would display base-fret 14.
Version 2.10.0; December 2012

New features in this release:

  • Added built-in chord definitions for Ukulele (standard C6 tuning: G4 C4 E4 A4).
  • Added a checkbox to scan for songs in subfolders (the default is to not scan in subfolders).
  • Added a "Delete Song" menu item.
  • The full screen presentation can, optionally, start from the selected song.
  • Rearranged the File menu items so that the commands related to song files are at the top (the historical emphasis on songbook-related commands was confusing new users).
  • The shortcut keys for "New Song" and "New Songbook" have been swapped.
  • When the songs list has keyboard focus, Ctrl+A will select all songs.
  • Added key signature to the sample song, "Twinkle Twinkle Little Star."

Fixes and minor changes:

  • Fixed a potential crash when parsing malformed chord directives.
  • Fixed the base fret field in the custom chord editor so that it will not allow typing the value 0. (The smallest fret is number 1.)
  • Fixed automatic song numbering in the RTF output.
  • Fixed a problem where ChordPro export would drop spaces between words when there was also a chord between the words.
  • Fixed a UI glitch where the grids and do-re-mi checkboxes would sometimes be disabled even though the chords checkbox was checked.
  • Added the key signature directive to the sample song "Twinkle Twinkle Little Star."

Songsheet Generator 2.9

Version 2.9.3; September 2011

Fixes and minor changes:

  • Fixed the ChordPro parser so that directives are no longer case-sensitive.
  • Improved the chord spacing and hyphenation when chords are placed over spaces in the lyrics.
  • Fixed the base fret field in the custom chord editor to allow fret values greater than 9.
  • When Songsheet Generator encounters a bad song file, it will usually display the name of the file that caused the problem.
Version 2.9.2; June 2011

Fixes and minor changes:

  • Fixed a problem where the help menu would not launch the online help.
Version 2.9.1; March 2011

New features in this release:

  • Printer margins and tabs can now be set in either metric (mm) or imperial (inch) units.
  • Added Rich Text (RTF) output. RTF will retain the font settings and colors from the printed output, as well as margins and column settings. Hyphenation is not supported, and line breaks may not match the printed output.
    Please note that RTF is a document exchange format, and does not guarantee specific typesetting. The appearance of the RTF depends on the software displaying it, and many programs ignore much of the RTF formatting (these programs include WordPad on Windows; and TextEdit, Pages, and QuickLook on the Mac). For best results, view the RTF in Microsoft Word or OpenOffice.
  • Songsheet Generator now supports multiple key signatures in a file. When more than one {key: } directive is detected in the song, all the keys will be shown next to the song title in the print list. The "Transpose to Key" menu will indicate transposition of the main (first) key; all the keys will be transposed relative to the transposition that is applied to the main key.
  • Multiple key signatures can be addressed in the footer using a dash followed by the key number in the song to the usual key directive (%k). For example: %k-1 is the first key in the song (and produces the same result as %k); %k-2 produces the second key in the song; and so on.
  • The table of contents can now be printed on its own physical page.
  • International characters (such as Japanese) can now be entered in the Importer.
  • .

Fixes and minor changes:

  • Unicode (UTF-8, UTF-16) text will now be imported correctly, both when using the Importer as well as the Songsheet Generator Import function.
  • The songs path for new installs is set to a new folder "Songsheet Generator Songs" within the user's Documents folder, rather than within the installed program folder. Upgrades from old versions will retain the previously set songs path setting.
  • The "chordrc" file that holds user-defined chords is now stored in %APPDATA%\Ten by Ten\chordrc, rather than in the folder where Songsheet Generator is installed. This version of Songsheet Generator will move any existing chordrc file to the new location.
  • Updated the online help.

User interface improvements:

  • Added a control to quickly pick the output destination on the main dialog. This has the same function as the list of output destinations found in the Options Menu, but is easier to find.
  • Added a "Reveal Songs in Explorer" menu command. This command will open a new Explorer window displaying the contents of the songs folder.

Songsheet Generator 2.8

Version 2.8.5; September 2009

Fixes and minor changes:

  • Fixed a problem where song key signatures were skewed by the "all songs" transpose setting.
  • Fixed the handling of UTF-16 Unicode song files so that the entire song is displayed.

User interface improvements:

  • Changed the "Songs to Print" List label to indicate that the list is equivalent to the contents of the current Songbook.
Version 2.8.4; July 2009

Fixes and minor changes:

  • Fixed a number of problems that would crash the program, including when chords were embedded in a comment.
  • Fixed a problem that would show the registration dialog, even when the software had already been registered.
  • The ‘usage’ column in the data key/value editor now shows the format that should be used to produce the data value in the footer. (Previously, this column showed how to define the key and value in a song; but that was not very useful, since the value was already defined in the editor!)
  • For registered users, Songsheet Generator will automatically check the Ten by Ten website for updates to the software (automatic checking can be disabled, if you prefer). No personal information is uploaded during this check.
Version 2.8.3; March 2009

Fixes and minor changes:

  • Fixed a problem that would crash the program when changing the songs path, when running under an unprivileged user account.
  • Fixed a problem where the chords and the last line of lyrics would overlap on the printed page.
  • Updated the 'browse for folder' dialogs to be resizable.
Version 2.8.2; January 2009

Fixes and minor changes:

  • Fixed a problem that would crash the program when the Table of Contents was used.
Version 2.8.1; November 2008

Fixes and minor changes:

  • Fixed the small chord spacing problem caused by hyphenation of lyrics.
  • Fixed a problem where the program would crash or stop scanning song files in version 2.8.0.
  • Removed the extra space that appeared after instrumental comments in version 2.8.0.
Version 2.8.0; October 2008

New features in this release:

  • Added Unicode song file support. Songsheet Generator can use UTF-16 and UTF-8 song files as long as they have a byte-order mark (BOM).
  • A setting was added to interpret all song files as UTF-8. This setting is not enabled when upgrading from an older version of Songsheet Generator, to ensure compatability with older song files; new installations will have this setting turned on by default. Please use the checkbox on the General Options page to switch between the old Songsheet Generator behavior and this new behavior. For more information on file encoding, see the online help.
  • Added a preference to start each song on a new physical page, regardless of the page layout style. A checkbox to control this has been added to the Print Options page. (ChordPro note: this has the same function as putting a {npp} at the top of every song.)
  • Added a "Save to ChordPro" output option. This function allows songs to be exported with their chords transposed in ChordPro, or without their chords. In effect, the songs will be exported with ChordPro directives that match the print settings. Please note that the ChordPro syntax may differ slightly from the syntax in the original song. Data values and chord definitions will be retained, but their ordering may be different from the original file. This function uses abbreviated ChordPro directives (e.g. "t:" for "title:"). Please do not use this function to overwrite your original songs—it may result in data loss! (Songsheet Generator does try to prevent you from doing this.)
    Note: If multiple songs are selected into the "Songs to Print" list, they will all be saved to a single file, with {ns} directives between them.
    Also Note: If you attempt to bring one of these multiple-songs-per-file files back into Songsheet Generator, only the first song title will appear in the songs list.
  • Song titles may optionally be wrapped, instead of reduced, to fit in a single line. A checkbox to control this has been added to the Print Options page.
  • Added an optional HTML output command-line option:
    sg02.exe [options] [songbook.sgb]
          options:  -fullscreen    starts fullscreen mode if songbook.sgb is ok
                    -maximized     maximizes the main dialog 
                    -minimized     minimizes the main dialog to the taskbar
    		-html file     creates html output file [file] from songbook.sgb 
                    -print         prints songbook.sgb with the default settings
                    -exit          exits after performing the command-line operation
    
    For more information, see the online help.

Fixes and minor changes:

  • Multiple monitors of different sizes are now handled correctly. In previous versions of Songsheet Generator, the primary monitor dimensions would constrain the dimensions of the secondary monitor, so that (for example) if a larger display was used as the secondary monitor, and it was used for full screen presentation, the entire screen area would not be used for song text. In addition, mouse clicks on the control icons are now registered correctly on the secondary monitor.
  • Improved the document name that appears in the print queue. The document title will be the songbook name, or the first song title in the print list, followed by "Songsheet Generator."
  • Updated the Windows print and page setup dialogs. It is now possible to adjust the printer margins directly from the page setup dialog; the printer margins set in the print options dialog are synchronized with those in the page setup dialog.
  • Clarified the exclusivity of guitar and ukulele mode by changing the checkbox to a pair of radio buttons.
  • Improved integration of the mini-preview and fonts panels with Windows visual styles (themes).
  • Added a new high-resolution icon for Windows Vista.
  • Comments and instrumental comments with no text in the directive (i.e. {gc:}) no longer cause errors in song printing.

Songsheet Generator 2.7

Version 2.7.2; February 2008

Fixes and minor changes:

  • Fixed a problem that would sometimes cause song scanning to stop with an error message.
  • Fixed a chord spacing problem on chord lines without lyrics that begin with spaces.
Version 2.7.1; December 2007

Fixes and minor changes:

  • Removed erroneous page numbering from the HTML Table of Contents (page numbers do not apply to HTML output).
Version 2.7.0; December 2007

New features in this release:

  • Added a Ukulele mode; this will cause chord grids to appear with only four strings. Since there are several tuning options for Ukulele, there are no built-in chords; please use the chord editor to define your chords. It is possible to freely switch back and forth between the normal six-string and four-string modes, but all songs will print in the current mode; i.e. there is no way to identify a song as a Ukulele- or six-string-only song.
  • Added a global data key/value editor. Key/value pairs defined in this editor will be applied to all songs. By using a global value, it is possible to define rarely-changing global text such as an organization name or other identifying information. The editor shows the text that must be entered in the song file to make use of the data key/value pair that has been defined.
  • Added a "New Song File" command in the File menu. This will create a new file in the songs folder, fill it with a simple ChordPro template, and open the text editor.
  • Added an option to turn off the automatic rearranging of song names that begin with ‘A’, ‘An’, or ‘The’.
  • The Song Importer program now provides a list that allows the key signature to be chosen for a song; the key will be written into the song file using the {key:} directive.
  • Lines of chords without lyrics will be wrapped if they exceed the margin, just as normal lines are wrapped.
  • Songsheet Generator will now print only the page range that is requested in the print dialog.
  • The window title will now indicate a modified songbook by appending a star (‘*’) to the filename.

Fixes and minor changes:

  • Fixed Full Screen Presentation mode so that it covers the Windows task bar (as it used to do).
  • Fixed an error that occurred when the songs path was changed or refreshed (or when F5 was pressed) before Songsheet Generator had finished scanning the songs folder.
  • Removed an extra line that would appear between chord lines without lyrics at the end of a song, when no grids were printed, in continuous-column page layouts.
  • Fixed chorus markings so that they correctly continue from one slide to the next in Full Screen Presentation mode.
  • The current songbook is now marked as modified when changes are made by using the context menu in the print list.
  • Fixed a problem where certain accented characters would cause text and HTML output to fail.

Songsheet Generator 2.6

Version 2.6.0; August 2007

New features in this release:

  • Added a custom chord definition editor (this has been needed for a long time!). (For those who are in the know about the original chord program, this dialog is an editor for the chordrc file.)
  • Added an "Instant Full Screen" function. This will present the songs selected in the Songs List, irrespective of whether or not they have been added to the Print List.

Fixes and minor changes:

  • Songbooks are now saved in a format that preserves international characters; in addition, this format is compatible with SG for Mac 1.3.4 and above.
  • Fixed automatic song numbering.
  • Song titles on overflow pages will now also have automatic song numbering applied.
  • Songsheet Generator will prompt to save an unsaved songbook before exiting.
    Note: the prompt will only be shown if the songbook has already been saved to a file.
  • Updated the online help.

Songsheet Generator 2.5

Version 2.5.3; July 2007

Fixes and minor changes:

  • Fixed a problem that would crash the program when the Table of Contents was used.
Version 2.5.2; June 2007

Fixes and minor changes:

  • Comments, instrumental comments, and tabs will now print in the colors as selected in the font options.
  • Further improved the footer text wrapping so that text blocks will tend to fill out more fully from top to bottom.
  • Prevented more than one footer from printing on any given page. On pages where more than one song appears, the footer will be created with data from the first song on that page.
  • Added an indication in the About Box as to whether or not the application has been registered. If the application has been registered, confirmation will be requested before entering a new registration code.
  • Saving and loading options settings was not working on certain Windows configurations.
Version 2.5.1; May 2007

Fixes and minor changes:

  • Improved the text wrapping for overlapping left-, center-, or right-aligned footer text blocks.
  • Fixed improper indentation in the line-with-indent chorus marking.
  • The thick line chorus marking should now be consistently thick when printing to a printer.
  • Fixed a problem with blank lines in guitar tab sections in HTML output.
  • Updated the sample song.
Version 2.5.0; April 2007

New features in this release (there are many!):

  • Added a Rescan Songs menu item (it’s in the File menu).
  • Rescanning songs will now attempt to keep the contents of the print list intact (if the filenames are the same).
  • Added key signature directive.
  • Added Transpose To Key menu. If the key has been defined for a song, the right-click popup menu in the Print List will display a list of target key signatures (major or minor keys will be shown, as appropriate).
  • If the key signature has been defined for a song, it will show up in brackets before the song title in the Print List.
  • Moved chord and grid options to a dedicated property page in the options dialog.
  • Grids may be limited to only appear only for "friendly" key signatures. (This will take effect only for songs where the key signature has been defined.)
  • Added support for generic data key/value directives in the song file. Keys and their values are noted like this: {d_abc: xyz} where abc is the key and xyz is the value. This feature can be used for defining tags such as CCLI number, author, etc. Global keys and values for all songs can be defined in the registry; user interface support will be implemented in a future version to manage these keys and values.
  • Added per-song footer format override support.
  • Added new footer codes for printing key, page numbering with a song, subtitles, and defined data keys/values.
  • Added conditional footer formatting, via the %? and %?! value query codes.
  • Added support for footer wrapping.
  • Added support for manual line breaks in the footer (put ’\n’ in the footer text).
  • The title and subtitle lines may now be flexibly formatted via the registry. These lines use the same formatting strings as the footer. The default title format string is %c%t, and the default subtitle format string is %c%s; these mimic the classic Songsheet Generator format. To get left-justified titles, change them to %l%t and %l%s. Data keys can also be used, to insert song data. There are lots of ways to customize the output...!
  • Added a separate font setting for guitar/intstrumental comments.
  • Made the import more permissive of extra characters in the chord line.
  • Further extended the ChordPro chord definition syntax to support defining chords that apply only to a given key signature. When defined this way, chords will revert to the standard definition when the song is transposed (or, to another chord defined for the transposed-to key signature). This is optional; when the "key" keyword is not added to the chord definition, the chord definition will apply to all keys. The complete chord definition syntax recognized by Songsheet Generator is:
    {define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E> fingers <Low-E> <B> <G> <D> <A> <E> key <KEY>}

    For example:
    {define: E5 base-fret 7 frets 0 1 3 3 x x fingers - 1 2 3 - - key E}

    All of Songsheet Generator's built-in chord definitions still apply to all keys.

Summary of new song directives:

DirectiveDescription
{data_abc: xyz}Data key and value; abc is the key, xyz is its value.
{f_abc: xyz}Shorthand for {data_abc: xyz}.
{footer: xyz}Footer override for the current song.
{f: xyz}Shorthand for {footer: xyz}.
{key: xyz}Key the chart is written in; xyz is a valid key; transposition will apply.
{k: xyz}Shorthand for {key: xyz}.

Summary of new footer formatting codes:

CodeDescription
%’abcData key value (abc is a key; xyz, its value, will be printed). Note: the quotes are required!
%?jkl"xyz"Value query jkl is a format code; if the value of jkl is not empty, then xyz will be evaluated and printed; xyz may contain nested format codes). Note: the quotes are required!
%?!jkl"xyz"Value query (negative) jkl is a format code; if the value of jkl is empty, then xyz will be evaluated and printed; xyz may contain nested format codes). Note: the quotes are required!
%kSong key (transposition will apply).
%NTotal number of pages of song.
%PCurrent page number of song.
%sSong subtitle.
%xSong transpose (in half-steps; if the value is zero: nothing, not even a blank, will be printed).
\n (backslash followed by 'n')Manual line break in the footer.

Fixes and minor changes:

  • If a chord is defined within a song, but the song is transposed: preference will be given to Songsheet Generator's internal definition of the transposed chord, when printing grids.
  • Due to a new method for reigstering title and key/value data, it is necessary to rescan songs for some song file changes to show up in the output. Songsheet Generator previously re-read the entire song file when printing or previewing; this is no longer completely true.
  • In previous versions, a value of 0 for transposition would print as '0' when %x was defined in the footer. As of version 2.5.0, nothing (not even a blank) will be printed if the transposition value is zero.

Songsheet Generator 2.4

Version 2.4.1; November 2006

New features in this release:

  • Added a combination line-and-tab chorus marking style.

Fixes and minor changes:

  • Fixed a problem that sometimes caused the first chord symbol to be shifted up one line. This problem was due to the "Automatically single-space lines with no chords or lyrics" option; the option has been removed from the program.
  • A blank footer on the Printer settings would prevent a footer from printing in the Full Screen display; this has been fixed.
Version 2.4.0; March 2006

New features in this release:

  • Chords can now optionally be shown in Italian Notation (do re mi fa sol la si). A checkbox on the General Options page controls this behavior, which performs the change to Italian Notation when the songs are printed or displayed. Please note that ChordPro files should still be entered using C D E F G A B notation; Songsheet Generator will not recognize Italian Notation in the ChordPro files.
  • Several new chorus marking styles are available, including shaded filled box and tabbed indentation; to accomodate these choices, the Printer Options page now contains a dropdown menu of chorus marking styles.

Fixes and minor changes:

  • Chords appearing without lyrics on the last line of a song file will now print correctly, even when chord grids are being printed.
  • Corrected a spelling error in the registration dialog.
  • Fixed a chord definition problem that would occur when reading chord definition directives that do not include a colon.

Songsheet Generator 2.3

Version 2.3.2; January 2006

Fixes and minor changes:

  • Print preview has been fixed. Reverted to VC6 build, to remedy this and some other problems that appeared in the VC8-built version 2.3.1.
Version 2.3.1; December 2005

Fixes and minor changes:

  • This version of Songsheet Generator is statically linked with the newest MFC and CRT libraries, for improved performance and up-to-date functionality.
  • When using the Full-Screen Presentation on multiple monoitors, the pointer is only hidden on the monitor that is used for the song display.
  • Chords are better aligned in the text output. Since no hyphenation is used in the text output, however, some chords will not align exactly. Further detailed spacing alignment must be performed manually.
  • The default Full Screen font color will use the 2.2 foreground color, instead of white.
  • A memory corruption problem with file dialogs has been fixed. As a result of this fix, Windows 2000/XP will see the newer file dialogs in most places (with the favorites bar).
  • Fixed an unusual problem where settings would not be saved or loaded.
Version 2.3.0; September 2005

New features in this release:

  • Improved font control is available through an extended dialog on the Print and Full Screen Options pages. Please see the online help for further details.
  • Tab characters in song files are now expanded to a user-definable space. Separate spacing values are available on both the Print and Full Screen Options pages; the Print spacing value is based on inches, and the Full Screen spacing value is based on a percentage of the screen.
  • Multi-monitor support has been added to the program. On the Full Screen Options Page, it is now possible to select the desired monitor from a list of connected displays.
  • Registration is now required in order to permanently disable a nag screen that appears from time to time.

Fixes and minor changes:

  • A manually-selected page orientation (portrait or landscape) in the Printer Setup dialog or Print dialog will now be saved and reflected properly in the Print Preview display, Printer Setup dialog, and Print dialog. When a different Page Layout is chosen, however, the orientation will revert to the default for that layout. The default orientation is landscape for "2 Discrete Cells Per Page," and portrait for all other layouts.
  • The default value of the Song Editor has been set to the expanded value of %WINDIR%\Notepad.exe.
  • The high-color icon has been changed to look like the Mac OS version (which looks better on Windows XP, too).
  • Sometimes it was not possible to print more than one time in Windows 9x/ME. This has been fixed.

Songsheet Generator 2.2

Version 2.2.3.1; October 2004

New features in this release:

  • Many more image formats are now supported for the background of the Full Screen Presentation: BMP, GIF, JPEG, PNG and TIFF should all be selectable. A PNG with transparency will overlay the currently selected background color.
  • Introducing the Songsheet Generator Importer!
    A tiny application is now included in the Songsheet Generator installation which makes it easy to enter new songs without learning about the ChordPro format. Simply type the song title, add some other information if desired, and type the song text with chords above the lines like this:
    A          D        A  D
    This is my new song la la
    
    then press the "Save Song" button and supply a filename. After the file is saved, if Songsheet Generator is running, its Song List will be automatically refreshed to include the new song file.
    The Importer can be accessed via the Start Menu.

Fixes and minor changes:

  • Fixed a bug related to the code page for converting text in the HTML output.
  • Enabled mouse scroll wheel support in the Mini-Preview window.
Version 2.2.1.2; August 2004

Fixes and minor changes:

  • The default behavior of Songsheet Generator has always been to apply all of the Options settings when leaving the Options dialog. This can have the undesired effect of resetting transposition and "print chords" settings in the "Songs to print" list — when, for instance, simply a font size is changed. This behavior is by design, but it was pointed out that it is sometimes less than helpful. So, there is now by default a warning message before the transposition and "print chords" settings are applied; and, optionally, songs in the "Songs to print" list will be unaffected.
    This warning message can be turned off, to return to the usual SG behavior.
    Note: no warning is given when changing these settings via the menu.
  • A chorus that runs onto the next page wll now correctly receive the (optional) chorus marking on the initial page.
  • A chorus that is not properly closed with {eoc} or {end_of_chorus} before the end of the song will now receive an (optional) chorus marking. (The same problem was also fixed in the HTML output, and for {eot} and {end_of_tab} as well.)
  • Even if the last line in a song file does not end with and end-of-line character, the line will now print correctly.
  • Chords appearing without lyrics on the last line of a song file will now print correctly.
  • All chords defined in a song file will now be printed in the set of chord grids, even if those chords are never used in the song.
    Note: this new behavior can be turned off in the registry.
Version 2.2.0.1; February 2004

New features in this release:

  • Added Page Numbering!
    Now it is possible to print a full-featured paper songbook using Songsheet Generator. The Table of Contents will reflect the proper page numbers.
    Note: this is not the same as Automatic Song Numbering, a separate feature that was added in version 2.1.1.0. Both Page Numbering and Automatic Song Numbering can be used at the same time. Using them both produces a hymnbook-like system, where songs have separate numbers from the physical pages that they appear on.
  • Added footer support for Printer, Full Screen and HTML output destinations. The footer text will appear at the bottom of the physical printed page, at the bottom of the screen, or at the end of the HTML <body>. Any text can be used, but the following control codes can also be used to format the footer:
    CodeDescriptionExample Output
    %l (lowercase 'L')Left-justify text following (printer & full screen only)
    %cCenter-justify text following (printer & full screen only)
    %rRight-justify text following (printer & full screen only)
    %pCurrent page number
    %nTotal number of pages
    %tSong titleMy Song
    %TSong title, with subtitle, if it exists (in parenthesis)My Song (Reprise)
    %fSong filenamemy_song.txt
    %FSong filename (complete path)C:\songs\my_song.txt
    %xSong transpose+3
    %dyTwo-digit representation of current year04
    %dYFour-digit representation of current year2004
    %dmNumeric representation of current month, with leading zeros01 to 12
    %dnNumeric representation of current month, without leading zeros1 to 12
    %dMShort textual representation of current month, three lettersJan to Dec (localized)
    %dFFull textual representation of current monthJanuary to December (localized)
    %ddCurrent day of the month, 2 digits, with leading zeros01 to 31
    %djCurrent day of the month, 2 digits, without leading zeros1 to 31
    %dDShort textual representation of the current day of the weekSun through Sat (localized)
    %dl (lowercase 'L')Full textual representation of the current day of the weekSunday through Saturday (localized)
    %drRFC 2822 formatted dateThu, 21 Dec 2000 16:01:07 +0200
    %%Percent sign ('%')
  • Added support for the ChordPro {new_page} ({np}), {new_physical_page} ({npp}), and {column_break} ({colb}) directives.
    • {np} will cause a "cell break" in the Two and Four Discrete Cells per Page printing modes, and a column break in the Two Flowing Columns printing mode. It will cause a physical page break otherwise.
    • {npp} will always force a physical page break.
    • {colb} will force a column break in the Flowing Columns printing modes, which amounts to a physical page break in the One Flowing Column printing mode. It has no effect in the Discrete Cells printing modes.

    Note: these directives have no effect in the Text and HTML File output destinations.

Fixes and minor changes:

  • Sorting in the Songs List is now closer to a library-style sort. It would be nice to do things exactly the way that NISO TR03-1999 recommends, but this is really complicated and full of special cases for numbers and symbols. At least the sorting is pretty close to this, now, and much better than it was previously.
  • Full Screen Presentation, while it is open, will disable the screen saver from starting.
  • Slides in Full Screen Presentation can now also be navigated by using the Page Up and Page Down keys.
  • Corrected a problem in which a small extra chorus mark would appear when a song overflowed to a new column or cell just at the point of the chorus.
  • Removed the following extra <div class=sg_newsong> tags: before and after the HTML TOC, and at the end of the HTML output.
  • Prevented SG from crashing when the default (and possibly only) printer is on a network, but is not available.
  • Converted the Release Notes document to HTML.

Known problems:

  • Unicode (UTF-8, UTF-16) text files are not imported correctly. Multi-byte files work OK, if they are consistent with the current locale setting.

Songsheet Generator 2.1

Version 2.1.1.0; December 2003

New features in this release:

  • HTML output is now writing UTF-8. Using UTF-8 overcomes the display problems that were formerly encountered with various web browsers and language settings.
  • HTML output adds additional style tags for the song body and the Table of Contents: sg_song, sg_toc, sg_toc_header, sg_toc_contents now allow further control over the appearance of the HTML output.
  • Added a feature to automatically number the printed songs. The song numbering is also reflected in the Table of Contents. A checkbox for this feature can be found on the General Options dialog. The setting applies to all of the Output Destinations, except for the Full Screen Presentation. Also, the number is never shown in the Mini-Preview.
    Note: Automatic Song Numbering is not the same as page numbering (a feature that is not yet supported).

Fixes and minor changes:

  • HTML output now validates as HTML 4.01 strict. Related to this change, the internal song linking now uses <div class=sg_song id=...> instead of <a name=...>.
  • Fixed a printing problem in which the first line of a chorus would not receive the full "line" chorus mark, when it had no chords, and SG was set to print chords.
Version 2.1.0.7; October 2003

Changes to the software in this release:

  • Chords grids are now sorted alphabetically.
  • Another minor internal fix in the chord definition syntax.
Version 2.1.0.6; September 2003

Changes to the software in this release:

  • Fixed the chord definition syntax to correlate with chord 3.6. The correct syntax follows (and has been corrected in the 2.1.0.1 notes below to avoid further confusion):
    {define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E>}

    or
    {define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E> fingers <Low-E> <B> <G> <D> <A> <E>}

    Other versions are also recognized by Songsheet Generator (where the colon appears after the chord name, or where there is no colon at all).
  • Fixed two import problems: multiple files imported at the same time will now import correctly; and the extra carriage return was removed.
  • Fixed a problem in which songs with very ugly chord definitions (longer than 16 characters) would crash the program.
  • Songbooks are now always saved with the current transpose and chord printing settings so that when opened they always have the right settings (songs with zero transpose would default to the current setting).
Version 2.1.0.1; August 2003

Changes to the software in this release:

  • Added the "Printer Setup..." command. Songsheet Generator will now remember the printer selection and custom printer settings from one print job to the next (but not the next time the application is launched). Also the Print Preview will obey the settings from the Printer Setup dialog. Note, however, that the page orientation is chosen automatically for each print job based on the current page layout style.
  • Added the "Set Path to Songs..." command in the Options Menu. The browse dialog is now also populated with the current path.
  • Enabled Alpha Blending as a slide transition, on platforms that support it (98/Me/2k/XP). In addition, fonts are always smoothed, even if smooth fonts are not set in the Windows Display Control Panel.
  • Corrected a problem in which the overflow song title would print at the top of a new song in a new column in flowing column page layouts.
  • Corrected a problem which would prevent certain songs with Japanese titles from appearing in the song list.
  • Corrected a problem in which the cursor would not disappear when entering Full Screen Presentation mode after the first time.
  • Added the ability to print chord grids. This feature may be turned on and off via a checkbox in the General Options dialog. The size of the grids is automatically varied to fit within the page constraints: Songsheet Generator will attempt to fit the largest possible grids onto the fewest possible lines.
    The most commonly used chord grids have been built into the Songsheet Generator executable (see below). Additional chord grids may be defined in song files, via the standard ChordPro chord grid definition syntax:
    {define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E>}

    For example:
    {define: E5 base-fret 7 frets 0 1 3 3 x x}

    Chords grids defined in songs will override any built-in definitions.
    In addition, an extension to the standard format is recognized by Songsheet Generator, which adds fingering support to the grid. Fingerings are printed below the chord grids. The syntax for the fingering definition follows:
    {define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E> fingers <Low-E> <B> <G> <D> <A> <E>}

    For example:
    {define: E5 base-fret 7 frets 0 1 3 3 x x fingers - 1 2 3 - -}

    The following chords have been built into Songsheet Generator. Songs using chords noted in this list will benefit automatically from the new chord grids feature:
    Ab, Ab+, Ab4, Ab7, Ab11, Absus, Absus4, Abdim, Abmaj, Abmaj7, Abmin, Abm, Abm7, A, A+, A40, A6, A7, A7+, A7(9+), A9, A11, A13, A7sus4, A9sus, Asus, Asus2, Asus4, Adim, Amaj, Amaj7, Adim, Amin, A/D, A/F#, A/G#, Am, Am#7, Am(7#), Am6, Am7, Am7sus4, Am9, Am/G, Amadd9, Am(add9), A#, A#+, A#4, A#7, A#sus, A#sus4, A#maj, A#maj7, A#dim, A#min, A#m, A#m7, Bb, Bb+, Bb4, Bb6, Bb7, Bb9, Bb11, Bbsus, Bbsus4, Bbmaj, Bbmaj7, Bbdim, Bbmin, Bbm, Bbm7, Bbm9, B, B+, B4, B7, B7+, B7+5, B7#9, B7(#9), B9, B11, B11/13, B13, Bsus, Bsus4, Bmaj, Bmaj7, Bdim, Bmin, B/F#, BaddE, B(addE), BaddE/F#, Bm, Bm6, Bm7, Bmmaj7, Bm(maj7), Bmsus9, Bm(sus9), Bm7b5, C, C+, C4, C6, C7, C9, C9(11), C11, Csus, Csus2, Csus4, Csus9, Cmaj, Cmaj7, Cmin, Cdim, C/B, Cadd2/B, CaddD, C(addD), Cadd9, C(add9), Cm, Cm7, Cm11, C#, C#+, C#4, C#7, C#7(b5), C#sus, C#sus4, C#maj, C#maj7, C#dim, C#min, C#add9, C#(add9), C#m, C#m7, Db, Db+, Db7, Dbsus, Dbsus4, Dbmaj, Dbmaj7, Dbdim, Dbmin, Dbm, Dbm7, D, D+, D4, D6, D7, D7#9, D7(#9), D9, D11, Dsus, Dsus2, Dsus4, D7sus2, D7sus4, Dmaj, Dmaj7, Ddim, Dmin, D/A, D/B, D/C, D/C#, D/E, D/G, D5/E, Dadd9, D(add9), D9add6, D9(add6), Dm, Dm6(5b), Dm7, Dm#5, Dm(#5), Dm#7, Dm(#7), Dm/A, Dm/B, Dm/C, Dm/C#, Dm9, D#, D#+, D#4, D#7, D#sus, D#sus4, D#maj, D#maj7, D#dim, D#min, D#m, D#m7, Eb, Eb+, Eb4, Eb7, Ebsus, Ebsus4, Ebmaj, Ebmaj7, Ebdim, Ebadd9, Eb(add9), Ebmin, Ebm, Ebm7, E, E+, E5, E6, E7, E7#9, E7(#9), E7(5b), E7b9, E7(b9), E7(11), E9, E11, Esus, Esus4, Emaj, Emaj7, Edim, Emin, Em, Em6, Em7, Em/B, Em/D, Em7/D, Emsus4, Em(sus4), Emadd9, Em(add9), F, F+, F+7+11, F4, F6, F7, F9, F11, Fsus, Fsus4, Fmaj, Fmaj7, Fdim, Fmin, F/A, F/C, F/D, F/G, F7/A, Fmaj7/A, Fmaj7/C, Fmaj7(+5), Fadd9, F(add9), FaddG, FaddG, Fm, Fm6, Fm7, Fmmaj7, F#, F#+, F#7, F#9, F#11, F#sus, F#sus4, F#maj, F#maj7, F#dim, F#min, F#/E, F#4, F#m, F#m6, F#m7, F#m7-5, F#m/C#m, Gb, Gb+, Gb7, Gb9, Gbsus, Gbsus4, Gbmaj, Gbmaj7, Gbdim, Gbmin, Gbm, Gbm7, G, G+, G4, G6, G7, G7+, G7b9, G7(b9), G7#9, G7(#9), G9, G9(11), G11, Gsus, Gsus4, G6sus4, G6(sus4), G7sus4, G7(sus4), Gmaj, Gmaj7, Gmaj7sus4, Gmaj9, Gmin, Gdim, Gadd9, G(add9), G/A, G/B, G/D, G/F#, Gm, Gm6, Gm7, Gm/Bb, G#, G#+, G#4, G#7, G#sus, G#sus4, G#maj, G#maj7, G#dim, G#min, G#m, G#m6, G#m7, G#m9maj7, G#m9(maj7)

    Chord grids are not yet supported in the Text or HTML output.

Songsheet Generator 2.0

Version 2.0.0.13; April 2003

Changes to the software in this release:

  • Added mouse-click control to the Full Screen Presentation; a left-click will retreat, a right-click will advance. This behavior can be turned on/off in the Options dialog.
  • Multiple files may be selected in the Import dialog.
  • Added some more (hopefully) helpful error messages.
  • Fixed two bugs in Text Output: one would cause huge output files; another would get the chords confused when a line with only chords was encountered and autospace was turned on.
  • Fixed several bugs in HTML Output, including HTML TOC, and a mirror of the autospace problem in Text Output.
Version 2.0.0.12; January 2003

Changes to the software in this release:

  • More correct handling of line spacing and font heights (this may cause songsheets to be a bit more vertically spaced out than before).
  • Minor UI tweaks.
  • Plugged some very small memory leaks.
Version 2.0.0.11; November 2002

Changes to the software in this release:

  • Rewrote the chord printing routine to automatically space out lyrics when the chords are bunched close together. This will also hyphenate the lyrics, if needed, and now chords will also wrap properly when the lyrics need to wrap to the next line. This feature only works in printed output: HTML output causes lyrics to be spaced out, but does not insert a hyphen, and does not wrap. Text output does not space out the lyrics, nor does it wrap.
  • Changed the wording of the "Songs per Page" options: "1/2/4-per page" is now called "1/2/4 discrete cells per page" and "1/2-column continuous" is called "1/2 flowing columns per page." Finally, the option itself is now called "Page layout." There is no functional change; this just seems to be a more clear wording. The Print Options dialog has a new listbox with pictures that show the meaning of the page layout options. The Options menu has changed.
  • Fixed a printing bug: in certain circumstances the "1/2 flowing columns per page" option would produce no output.
  • Fixed full screen chorus marking when chorus wraps to the next slide.
  • Corrected HTML output to validate as HTML 4.01 Strict.
Version 2.0.0.10; September 2002

Changes to the software in this release:

  • Added transitions between slides in Full Screen Presentation. Also added an optional slide-projector-like blank delay between slides.
  • Added command-line options. See notes below.
  • Added save/load of options settings.
  • Improved import of tab files.
  • Proper handling "st" as abbreviation for subtitle (found in OLGA songs).
  • The Return key now maps to the focused control in the main dialog.
  • Minor printing fixes.
  • Improved the icon.
  • The installation will register .sgb files as type "Songbook (Songsheet Generator)" and create some default actions for them.
  • New optional command-line options:
    sg02.exe [options] [songbook.sgb]
          options:  -fullscreen    starts fullscreen mode if songbook.sgb is ok
                    -maximized     maximizes the main dialog 
                    -minimized     minimizes the main dialog to the taskbar
                    -print         prints songbook.sgb with the default settings
                    -exit          exits the program after all work is finished 
Version 2.0.0.9; July 2002

Changes to the software in this release:

  • Added import: this feature automates some of the conversion from plaintext tab files to the ChordPro format!
Version 2.0.0.8; May 2002

Changes to the software in this release:

  • Added support for ChordPro {start_of_tab} and {end_of_tab} directives.
  • Added online help.
  • Fixed a bug in the transpose function.
Version 2.0.0.7; April 2002

Changes to the software in this release:

  • Added Full Screen Presentation mode—a feature for song projection or performance. A BMP file may be selected for a custom background image.
  • Added a Table of Contents option. The Table of Contents may also be printed separately, from the "File" menu.
  • Split options into separate property pages; added many new options.
  • Mini-Preview can be hidden, if you don't want to see it.
  • Fixed several user interface, printing, & print preview bugs.
  • Stopped calling this a "Beta".
Beta 6 release: Version 2.006; April 2002

Changes to the software in this release:

  • Text lines that are too long to fit inside the margins will now wrap.
  • Fixed a threading bug on Win95/98/ME.
  • Song scanning is much faster now.
  • Added the "Other..." choice to Transpose menus.
  • Added accelerator keys for some menu functions.
Beta 5 release: Version 2.005; March 2002

Changes to the software in this release:

  • Songbook support; a list of songs can be saved for future re-printing.
  • Individual songs can be given different transpose settings. The transpose amount for each song is displayed in brackets before the song title in the print list. (Access this feature via the pop-up context menu by right-clicking in the print list.)
  • Individual songs can also be set to print or not print chords.
  • Mini-Preview now displays the most recently-selected song, whether it was selected in the song list or the print list.
  • Presentation of the HTML output is now controlled by a style sheet.
  • Added support for Windows XP visual styles.
Beta 4 release: Version 2.004; February 2002

This version is an almost complete rewrite. Changes to the software in this release:

  • Print Preview—finally!
  • Transpose! Transposing by positive half-steps will result in sharps; negative half-steps will result in flats.
  • A collapsable "Mini-Preview" pane displays a Print Preview of the most recently selected song in the Songs List.
  • The "Edit Song" menu command will open a text editor on the most recently selected song in the Songs List.
  • Font usage has been changed significantly:
  • All fonts sizes are based on the lyric font size. Title, subtitle, chord and comment fonts are offset from this base size.
  • An alternate font is used for Title, subtitle, chords, and comments.
  • Fonts maintain their size no matter how many songs per page you select; a 12 point font is really a 12 point font on the 4-per- page printout. This means you will probably need to increase the font size for a 1-per-page printout.
  • The "space above chords" and "space above lyrics" values have been removed in favor of simpler, common line spacing values.
  • New print modes: 1- or 2-column continuous modes can save paper, by just flowing from one song to the next.
  • Output to the printer, to a plain text file, or to an HTML file.
  • Songs are scanned and sorted in the background, for a more responsive user interface. Printing is also performed in the background.
  • Songs are sorted in a more logical way; the words "the," "an," "a" in song titles are moved to the end for sorting in the lists.
  • Selected items under the new "Options" menu allow quick changes of the most-used printing options.
  • All configuration options are available from a single dialog.
  • Removed the Galaxy toolkit, which reduces the footprint by about 90%. Really, no kidding! But now we're also bound to Microsoft...

Songsheet Generator 1.15

Changes to the software in this release:

  • Copyright transferred to Ten by Ten
  • Updated installation
  • Windows print mode is automatically set to portrait for 1 & 4 songs per page; automatically set to landscape for 2 songs per page
  • Windows printer is saved between sessions, if desired
  • Song selections can be made with the keyboard
  • Help available from the menu
  • Minor visual improvements, bug fixes and toolkit patches

New (and corrected) song files included in this release:

  • Apostle's Creed; Did You Feel the Mountains; God Is So Good; How Priceless; I Will Lift My Hands; Let It Burn; Let The River Flow; Mercy Mercy; No Other; We Will Ride; You Are Lord

Songsheet Generator 1.12.228

Changes to the software in this release:

  • Win32s is no longer a supported platform
  • Minor bug fixes and toolkit patches

Songsheet Generator 1.12

Third production release: Version 1.12; Summer 1996 - Spring 1997

Program files included in this release:

  • Microsoft Windows 95 / Windows NT / Win32s:
    songsgen.exe, songsgen.vr, vgalaxy5.vr, ReadMe.txt, HowToApplication.txt, HowToFiles.txt, PlatformNotes.txt, ReleaseNotes.txt, Songs (directory; see contents below)

Changes to the software in this release:

  • List of songs to be printed scrolls to a new entry when one is added
  • Count of songs shown at the top of each list
  • Resource file is now vgalaxy5.vr; vgalaxy2.vr is out-of-date

New (and corrected) song files included in this release:

  • Another Drink; Be Magnified; Eternity; Faithful Father; Father of Lights; Glorify; Holiness Unto The Lord; Holy And Anointed One; How Majestic Are Your Ways; Holy Is The Lord On High; I Could Sing Of Your Love Forever; Let's All Go Up To Zion; Lord We Praise You; More Love, More Power; Psalm 94; Resting Place; Spirit Of The Sovereign Lord; Sweet Mercies; There Is No One Like You; There Must Be More; True Love; Who Is Like Our God; Whom Have I But You; Will You Worship; You Are Mighty

Songsheet Generator 1.1

Second production release: Version 1.1; January 1996

Program files included in this release:

  • Microsoft Windows 95 / Windows NT
    songsgen.exe songsgen.vr vgalaxy2.vr ReadMe.txt SongsheetGeneratorHowTo.txt SongsheetFilesHowTo.txt PlatformNotes.txt ReleaseNotes.txt Songs (directory; see contents below)

New (and corrected) song files included in this release:

  • All That I Need; Blessed Be The Name; Crowns Down; Daniel's Prayer; Draw Me Close; Good To Me; Holy Love; In The Secret; Make Us A Prayer; Oh Lord You're Beautiful; Pour Out My Heart; The Lord Reigns; Throne Of Grace

Songsheet Generator 1.0

First production release: Version 1.0; October 1995.

Program files included in this release:

  • Macintosh
    Songsheet Generator, Help with Songsheet Generator, Help with Song File Format, Platform Specific Notes, Release Notes, Galaxy System Resources (2), Songs (folder; see contents below)
  • MS-Windows 3.x
    songsgen.exe, songsgen.vr, songsgen.txt, songfile.txt, platform.txt, release.txt, vgalaxy2.vr, songs (directory; see contents below), win32s (directory; see platform.txt)
  • UNIX flavors
    songsgen, songsgen.txt, songfile.txt, platform.txt, release.txt, lib/songsgen.vr, lib/vgalaxy2.vr, songs (directory; see contents below)

New song files included in this release:

  • Arms Of Love; Army of God; Be Magnified; Blessed Be the Name of the Lord; Break Dividing Walls; Come and Fill Me Up; Come and Fill Me Up (A Strangely Dominant Version); Draw Me Close; Exalt the Lord; Faithful One; Father of Lights; God Is So Good; Good To Me; Help Us Our God; His Banner Over Me; Holy Is the Lord On High; Holy, Holy, Holy; Hosanna (Holy, Holy, Holy); How Majestic are Your Ways; I Believe in Jesus; I Give Thanks; I Looked Up; I Will Come; I Worship You; Jesus You're Everything; King of Saints; Let Your Glory Fall; Let's Worship; Light of the World; Light the Fire Again; Lord of Every Man; Lord We Praise You; Lord, Your Name is Holy; More Love, More Power; No Other Gods; Oh Lord, You're Beautiful; Only The Blood; Pour Out Your Spirit; Psalm 9; Psalm 94; Psalm 121; Refiner's Fire; Remember Mercy; Resting Place; Save Us Oh God; Shout to the Lord; Show Your Power; Stay; The Victory is the Lord's; We Believe in You; We Will Dance; Whatever Is True; You Are Mighty; You Are Worthy of My Praise