PerfectGuitarSongBook Documentation

Help topics:
       Creating new songs
       The song screen
       Exporting Songs
       File Sharing
       External Displays
From the
artists or songs screen tap
+ at the top
right corner.
A screen
will appear, where you can
Set the
title of your new songs
Set the
artist of a new song
You may choose an existing artist by tapping the button below the
text field.
Link your
new song with a song in your song library.
If you play the newly created song later, you will be able to listen to the
linked song with a single tap. This is very useful if you want to know how some
passages of the song sound in the version of your favorite artist e.g.
Enter your
chords and lyrics in chord pro style like this:
      Thi[Am]s is a sample song
or in a style like this (spaces between chords):
       C                 G
     This is a sample song, too
may have to deactivate automatic points in the system settings to avoid typing
points after every second space. Sometimes, PGSongBook cannot recognize a line
as a chord line, because there are more normal words than chords in the line.
Thus, you have to write [] brackets around the chords in such a line.)

(Also see:
Chord Pro format

With the improved song editor of version 1.1, you just have to select a word
and tap one of the buttons in the menu bar to make the selected word a chord or
comment or just set the cursor to the desired position and set start/end of

Tap Done.
Navigate to
your song.
playing it.
Since version 1.3, if you start creating a
new song by setting a MP3, the app can fill all fields that are included in the
MP3 song automatically.
includes an editor that will help you when you have to create or edit the
chords and lyrics of a song.
Pinch with
two fingers (like in Safari) to easily change the font size.
Using the
different buttons in the footer bar helps you to insert Chord Pro directives. Some of them need
a selected phrase before you can use them.
Tap the magnifier
to search and replace a phrase/word/letter. If you have selected a phrase in
your song content, the replacement will only affect occurrences of the searched
string in your selection.
The magic
wand opens the menu for magic features.
Tap the arrow buttons at the right side of
the screen to scroll full pages up or down
If you move your finger in the middle of the
screen you may scroll to exact positions.
Tap the button next to the “Hide” button in the toolbar of the song screen to activate or deactivate Shake2Scroll.
With Shake2Scroll activated you just have to
give the table, where your device lies on, a soft boot to scroll a full page
down. (We do not take responsibility for any damage in connection with
Shake2Scroll, but unless you misuse this function, there should not be any
Since version 1.2, PGSongBook includes an
additional AutoScroll feature that helps whenever you cannot use Shake2Scroll.
Just swipe over the toolbar in the song screen from right to left and tap “AS”
(for AutoScroll). The AutoScroll toolbar will appear, featuring a slider, which
you can use to set the scrolling speed, and a button labeled with a triangle.
Tap this button to start or stop Auto Scrolling, A second tap on “AS” will hide
the AutoScroll toolbar again.
Since version 1.3, the AutoScroll speed is automatically saved for each song.
The linked (MP3) song in your iPod song
Tap the Play button in the tool bar to start the linked
If the
Play symbol is not enabled you have not linked a
song in your iPod library with your guitar song.
To change the position in a song, tap the button to the right of the play
button in the toolbar and use the slider that will appear.
Since version 1.1 there is an AB-Feature. It helps you to learn a special
passage of a song. To mark the start and end of that passage, tap AB at that
position while playing the MP3. To deactivate the AB-Mode tap AB again.
Transposing songs
Tap on the +– button and choose your desired interval.
Tap on the
+– button again to hide the picker again and apply changes.
Tap the export button (box with arrow; scroll toolbar on iPhone/iPod to reveal it) and choose the desired
exporting mode.
If you
export a song for File Sharing, you can download it from your device when you
connect it to iTunes the next time. (Also see:
iTunes File Sharing, you can easily upload your own Chord Files to Perfect
Guitar Song Book or download songs that you have created and exported in
PGSongBook. PGSongbook supports Pages, Word, PDF, .tab, .txt, .pro and .chopro. Chord Pro songs
may contain so-called Chord Pro directives. Unsupported Chord Pro directives
are just ignored and not displayed in the song screen. If a Chord Pro file has
Your Title}
and {subtitle: Your

at its beginning, PGSongBook will use the title (here: Your Title) as song
title and subtitle as the song
s artist
(here: Your Artist).
Connect your device with your PC/Mac and open
Select your Device in the Devices
list and choose
from the top bar.
Scroll down to File
and choose PGSongBook
from the left
Apps list.
Click Add
and navigate to some files to upload them to
the device or select files from the right
list and click
Save as‘ to download them to PC/Mac.
To import songs, tap Import
at the top left corner of the
Deleting Songs
To delete
songs, swipe over an entry in the list of songs (or an artist
s songs) from the left to the right and tap Delete.
To edit a
song open it and tap
at the top right corner of the Song Screen. You may then edit some fields. Save
changes by tapping
Tap on Playlists
on the main screen and tap
Enter a name for your playlist.
Tap Tap to add
and choose some songs.
Selected Songs will disappear from the list.
If you have selected too many songs, you may
delete them from the playlist in the
screen by swiping over them.
You can
easily edit playlists by tapping the right button in the title bar and choosing
Edit after
opening a playlist.
and importing playlists
the right button in the title bar after opening a playlist, then tap
Send‘ to send the playlist via email.
If you receive an email with an attached playlist,
just tap the symbol of the file to open PGSongBook, which will automatically
import the playlist.
song’s order in a playlist
the edit playlist or add playlist dialog, just tap and hold on the symbol with
the three lines next to each song and move it to the desired position in the
a PDF from a playlist
the right button in the title bar after opening a playlist, then tap
as PDF
‘ to send the PDF via email or tap View
as PDF
‘ to view the PDF.
You will notice that each of the two entries appears
twice in the menu, one of each followed by ‘(Desktop)’.
The difference is the links in the index of the PDF,
which refer to the songs.
The links in the file generated for desktop will only
work correctly on a desktop computer and not on a phone and vice versa.
The links included in the PDFs will not work in the ‘View as
‘ dialog but in the song view (If you import a PDF
generated by PGSongBook into PGSongBook) and in many PDF viewers for iOS
(included iBooks) (non-desktop PDF version) and for desktop computers (Desktop
PGSongBook you can easily use songs from nearly any page on the Internet:
In the New
screen, enter title and artist of the song
you would like to get from the Internet (And optionally choose a song in your
iPod library to link with this song)
2.    Tap Tap
to navigate to web page
‘. PGSongBook
automatically pastes the artist and title in the URL of the built-in web
browser (read this for more information) and sets up a
search on your desired web page.
Open any of the found
song should be composed of chord lines (chord separated by multiple space characters
or tabs) and text lines. Just select and copy the song (Sometimes just a long
tap on the right of the song), navigate back to the
screen and enter the text from the clipboard
into the
Chords and Lyrics
field (Hold your finger in the text field and tap
Info: there is a setting called Auto pasting that can
make this process a little bit faster.
Sometimes, PGSongBook cannot recognize a
line as a chord line, because there are more normal words than chords in the
line. Thus, you have to write [] brackets around the chords in such a line.
If there are tab keys between chords instead of spaces, PGSongBook will
ask you for the tabulator width in spaces and replace all tab characters with
Always check
if you may use a song before copying from the Internet!
Hint: You can always open the URL, which you have visited before
closing the browser by swiping over the navigation bar at the top of the screen
from the left to the right.
Songs in
PerfectGuitarSongBook are internally formatted in the widespread Chord Pro
format. This means that chords and lyrics are combined in one line:
Hell[C]o, thi[G]s is a te[D]st song.
In the
song screen songs are displayed as usual:
            C     G         D
this is a test song

(Chords are above the letter that follows after the “]”)
(Some browsers may not display the text right, here)
This does
not mean that you have to use the Chord Pro format to enter chords and lyrics.
You may enter separate chord lines and
text lines, too.
When using
the Chord Pro format, you may also use simple directives to format a song:
{start_of_chorus} or {soc}
(with brackets) sets the start of the chorus. PerfectGuitarSongBook will
display the chorus with a gray background.
{end_of_chorus} or {eoc} sets the end of the chorus.

Chorus Example:
This is just a verse…..

This is the chorus

This is just another verse…

{start_of_bridge} or {sob} sets the start of a bridge.
PGSongBook will display bridges with a gray background and a small
{end_of_bridge} or {eob} sets the end of a bridge.
{c: Your Text} or {comment: Your Text} allows you to
display blue comments.
{start_of_tab} or {sot} marks the following six (or multiples
of 6) lines as the lines of a tablature diagram (each line represents a string)
{end_of_tab} or
the end of a tablature diagram
{solc} marks the
beginning of a long comment. Chords in long comments will not get merged into
the text lines.*
{eolc} marks the
ending of a long comment.*
{h} can be
used to highlight a phrase in a song. Just place it once before and once after
the phrase you want to highlight. This is the only tag that can start and end
somewhere in a line.*
# lines with
this character at the beginning will be ignored (and hidden) for the song
* These
tags only work with PGSongBook and are no common tags of the ChordPro format.
With the improved
song editor of version 1.1, you just have to select a word or set the cursor
before/somewhere in a word and tap one of the buttons in the menu bar to make
the word a chord or comment or just set the cursor to the desired position and
set start/end of chorus/bridge.
These functions help you to complete incomplete songs.
Complete verse’s chords
Many songs from the Internet only have one verse that is provided with chords.
If you don’t know the chords by heart, it’s difficult the second or third verse
without chords.
This feature helps you to easily transfer the chords from the first verse to
all the others without chords.
Just choose this function from the magic features menu and follow the steps in
the title bar.
Mark choruses
This feature automatically finds and marks choruses with the {soc} and
{eoc} chord pro tag.
As this feature does not really work magically, the choruses cannot always be
The choruses should be introduced by a line containing “Chorus:” or “Refrain:”,
otherwise they won’t be recognized.
Complete Choruses
Lots of songs contain only one complete chorus and referrals to this one
complete chorus when the chorus should be played again later in the song.
This function pastes the complete chorus (if marked with {soc} and {eoc}) to
the places where “Chorus” or “Refrain” is only referred. If one of these words
is followed by x2 or 2x, the chorus will be pasted twice.
automatically detects connected external displays and displays songs on both
the device
s and the
external screen.
Note that
on devices that support screen mirroring, the whole app will be displayed on
the external screen.
You can
find the settings screen of PGSongBook in the Settings app on your device.
Start URL
Sets the start URL of the built-in web browser.
With version 1.1, this URL may contain %a, which will be replaced by the artist
of the currently edited song and %t, which will be replaced by the title.
With these two
placeholders you can easily create URLs, which will start a search. E.g.: will start
a search with your title and artist followed by the word
       Auto pasting (lyrics): If you have
this function active and open the chords and lyrics of a yet empty song, the
content of the clipboard will automatically pasted into the chords and lyrics
Shake2Scroll: Sets,
whether Shake2Scroll is enabled or not when opening a song.
AS bar when opening: Sets
whether the auto scroll bar is shown when opening a song or not.
Endless Shake2Scroll: If activated,
PGSongBook will automatically scroll to the beginning of the song when the end
of the song is reached with Shake2Scroll.
Big buttons: If
activated, the full page scroll buttons will be displayed at the full display
width like in versions until 1.2.
scroll (%) of page
: Here you may set the portion of the screen
(in percent: 100% is a full page), that is scrolled when using the
page-scrolling-buttons or Shake2Scroll.
time after Shake2Scroll (0-10 sec):
Shake2Scroll is
locked after every scrolling (with Shake2Scroll) for x seconds.
: Here you may set the sensitivity of Shake2Scroll.
Choose a lower value, if you don
t want
scrolling by mistake. (There should be no need to use too low values. Values of
more than half of the slider are usual.)
file after importing
: Activate this switch if you want PGSongBook
to automatically delete successfully imported song files.
Settings Song Screen:
Here you may customize the font of songs in
the song screen.
Settings PDF
: Customize fonts of the PDF files,which you can create
with PGSongBook.
Font Settings:
Here you may customize the font of printed songs.
Logging: If
activated, log files, that can help us to find bugs, will be attached to every
email sent through the help screen.
Please only activate
this if you are experiencing a bug and we asked you to send us log files!