# Preview Tasks

When you press the Preview button, ChordPro will generate a preview using default settings. The Tasks menu can be used for customized previews.

You can choose between the normal, default preview, a preview without chord diagrams, and a lyrics only preview for singers.

Choosing More… gives access to more possibillities.

An important difference is that now you can combine multiple settings. Also, you can transpose the song once, as opposed to the global setting for transpose that applies to all songs and all previews.

# Custom Tasks

The real power comes with custom tasks — you can add your own presets in the form of tasks. We’ll explain later how to do this.

In the example below there is one custom task, Chords on top.

Not surprisingly, this will create a preview with the chord diagrams on top of the page.

# How to create custom tasks

A ‘quick and dirty’ guide to creating custom tasks. If you are familiar with creating folders and files you can skip most of this.

You need to have a custom library. This can be an arbitrary, preferrably empty folder. In this guide we use ChordProLib in the home folder. Consult your system documentation on how to create this folder.
In this folder, create a subfolder tasks.
In the Preferences, set ChordProLib as your Custom ChordPro Library.
ChordPro will inform you that it needs restarting. Don’t do this yet.
Use the File > New menu to create a new song. Remove everything that is in the song so it is completely empty.
Type pdf.diagrams.show: top followed by Enter.
Use File > Save As… to get the save dialog. Navigate to your tasks folder and save with filename Chords_on_top.json. You need to manually type the filename.
Restart ChordPro. If everything went well there will be a task Chords on top added to the Tasks menu.