# PraiseProjector Help

PraiseProjector v2.0.97 · https://praiseprojector.hu/help/en/index.html

## Profile and database
(full-view, id: full/profile-database)

Your account selects the local and cloud song database, while the leader profile stores personal performance settings. Synchronization and sessions are also available here.
- User account: Your account selects the local and cloud database. Use the user control to sign in, switch account or sign out.
- Start synchronization: The main Sync button starts synchronization. If you have unsaved song edits, Discard & Sync drops those edits. To keep them, dismiss the prompt, save the song, and start Sync again. In guest mode, Download Public Songs starts the download.
- Status badges: ↑ marks local changes waiting to upload and ↓ marks downloads. A red count means songs need review. A cloud error can indicate either a lost connection or a session that needs a new sign-in.
- Attention badge colors: Dots on the view switcher and in client view identify the task: green for upload, blue for download, turquoise for both, and orange for offline. Red indicates another task, such as song review, an app update or signing in again.
- Synchronization menu: The Sync menu also offers Export database, Import database and Replace database with online. When signed in, open Songs to Review here. To import a song or score, use the import button on the song toolbar.
- Worship leader and leader mode: In your own session, the button opens the Leaders page in Settings. While following a PPD session, the same button switches between follower and leader mode when the host permits it; a blue highlight marks active leader mode.
- Worship leader profile: The leader profile stores song preferences, transpose, capo, instructions and scheduled playlists.
- Sessions: Start or follow local, web and cloud sessions with other devices.
- Profile and application settings: Detailed interface, projection, data, style and connection settings are available here.

## Song library
(full-view, id: full/song-tree)

Search, filter and group songs here. A selected song can be edited, added to the playlist and projected.
- Preference filter: With a worship leader selected, the heart button next to Search cycles through three views. The default view shows preferred and neutral songs. The second shows preferred songs only. The third also includes ignored songs. Other active filters apply in all three views.
- Mark a song as preferred: Select a leader profile. Click the heart next to a song to mark it Preferred, or click a filled heart to make the song Neutral. The song's context menu has a Preference row with Neutral, Preferred and Ignored. The filter beside the search box hides ignored songs with the empty heart, shows only preferred songs with the filled heart, and includes ignored songs with the eye icon.
- Search: Search by title, lyrics or other metadata, depending on your search settings.
- Search options: Traditional search can match similar text, respect letter case and require complete words.
- Content and language filters: All song types are enabled by default. The context menu's Filter submenu separately includes songs with chords, text-only, score-only and marked entries. General settings also has a song-language filter; if a song is missing, check these and the preference filter.
- Active filter indicator: The funnel appears when a content category is turned off, the song-language filter is set, or the preference view shows only preferred songs. To find an ignored song, use the heart button to switch to the view that includes ignored songs. Clearing the search field leaves these filter settings in place.
- Songs and groups: Folders represent related versions. Songs can be grouped with another song or added to the playlist.
- Drag and drop: Drag a song to the desired position in the playlist. To group songs, drop a song onto another song or a group folder. Dropping an external file into the song library opens the importer. It supports .chp, .abc, .musicxml, .xml, .mxl, .txt, .pdf, .docx, .htm and .html.
- Context menu: Right-click or press and hold a song to open its context menu. Use it to share the selected song. In guest mode you can delete the song here. With an account you can open its version history. Ungroup appears for songs in a group. Import from clipboard is available when the app can read importable clipboard content.
- Keyboard: With the song library list focused, Up and Down move by one song. Page Up, Page Down and Space move by a page. Shift+Space moves back a page. Home and End go to the first and last songs. Enter adds the selected song to the playlist, just like double-clicking. Delete removes the selected song from its group. Ctrl+V or Shift+Insert imports from the clipboard.

## Playlist
(full-view, id: full/playlist)

Build the running order here. Per-entry transpose, capo, custom title and instructions do not modify the original song.
- Playlist rows: The selected song is displayed; multiple rows can be selected together and reordered. An individual title, key, capo setting and instructions can be defined separately for each song.
- Load and save playlists: With a leader selected, Load and Save work with the leader's calendar and favorites (Load also offers the other own and the public leaders' lists); with no leader selected, they use a playlist file. The working list is a copy: changing it does not change the stored list until you save it there.
- Move playlist entries: Use the up and down arrows to move the selected playlist entries one position earlier or later.
- Transpose: Use the up and down arrows to raise or lower the selected playlist entries' per-entry transpose by one semitone.
- Capo: Use the up and down arrows to increase or decrease the capo value of selected playlist entries.
- Remove: Remove selected entries from the current playlist without deleting database songs.
- Edit playlist entry: Edit the selected entry's custom title.
- Add song: Add the selected library song to the current playlist.
- Title and instructions: Each playlist entry can have its own title and performance instructions. Double-click the title to edit it. Open the instructions editor in the rightmost cell with a double-click, or with one tap on a touchscreen. These settings belong to the playlist entry.
- Context menu and history: The context menu offers transpose, capo, selection, undo, redo and sharing for saved lists.
- Instructions editor: Source, Editor and Preview panes can be collapsed. Clear, reset and save the text, optionally storing it in the leader profile.
- Instructions for songs with notation: Parts and verses from supported ABC scores with lyrics can be used in the performance order. The instructions editor may show expanded parts as well as the whole score block. This changes the performance view without rewriting the original notation.
- Keyboard: Extend selection with Shift or select all with Ctrl/Cmd+A. Delete removes, Ctrl+Up/Down reorders and Alt+Up/Down transposes; edits can be undone.

## Song toolbar
(full-view, id: full/song-toolbar)

Reload and save songs, create or import a song, print, switch to client view and open settings from here.
- Reload song: Restore the database version; the app may ask before discarding unsaved changes.
- Save song: Store the current edit in the song database.
- New song: Create an empty song and start working directly in the editor.
- Import: Open the importer from the song toolbar. ChordPro and ABC files go straight to the editing step. MusicXML files are converted to ABC notation. When pasted text is recognized as ABC, the app asks before importing it as notation.
- Print: The current song can be printed here.
- Client view: In the full-view toolbar, Switch to mobile view opens the streamlined client view for performances. In the built-in tutorial, use Switch to client view to continue the tour there.
- Settings: Open Settings to configure search, song languages, projection, scores, hardware controls, leaders, styles, client permissions and networking. Use General for song language, Hardware control for keyboard and MIDI mappings, and Score for notation defaults.
- Language, hardware and scores:
  - Song language and filtering: In Settings → General, default song language supplies the initial language for new songs. The song-language filter restricts the library and related searches. This is separate from the interface language; edit an individual song's language on its Metadata tab.
  - Hardware control profiles: In Settings → Hardware control, first select full or client view: each has its own keyboard and MIDI profile. The factory profile is read-only; copy it to create and edit your own mapping.
  - Learn keyboard and MIDI inputs: On the Hardware control page, learn a key combination or MIDI signal for an action, or enter the binding manually. Conflict indicators help avoid overlapping inputs. MIDI requires a supported runtime and may require permission; its status is shown on this page.
  - Keyboard scope: In full view a key can apply only while the section list has focus, or across all full-view panels. The tutorial's keyboard descriptions refer to factory mappings; a custom profile can assign different actions. An open dialog takes priority over hardware commands.
  - Score defaults: Settings → Score sets default playback instruments, accompaniment and notation appearance. A score's own options take priority over these defaults. Changes take effect after saving Settings.

## Editor
(full-view, id: full/editor)

Edit the song visually, through metadata or as ChordPro source. Changes remain in local editor state until saved.
- Edit mode: The pencil switches between reading and editing. After changes, choose Save, Leave without saving or Continue editing when leaving; the last choice keeps your work in edit mode.
- Song editor: Edit lyrics and chords in a visual layout that resembles the finished song.
- Title: Turn the selected text into the song title.
- Verse: Mark the selected lines as a numbered verse.
- Chorus: Mark the selected lines as a chorus.
- Bridge: Mark the selected lines as a bridge.
- Chord grid: Mark the selected lines as an instrumental chord grid.
- Comment: Toggle selected chord-free lines between comments and normal lyrics. The button is disabled when the selection contains chords. A comment naming a section between sections (for example “Chorus 2x”) repeats it: read mode shows that section's first line ending in “...” under a grey label. Inside another section it is not an instruction, so a red wavy line marks it.
- ABC notation: In edit mode, insert a new ABC block at the caret or double-click existing notation to open the score editor. In read mode, double-clicking or double-tapping notation instead starts or stops its MIDI playback.
- Using the score editor: The score editor's Help button opens its own detailed tutorial. Apply transfers the notation into the song's editing state; Cancel discards the score editor's changes. After applying, also save the song to the song database.
- Visual editor context menu: The context menu provides undo and redo, clipboard actions, selection, chord insertion, title and section tags, comments, tag clearing, and whole-song semitone transpose. Actions that do not apply to the current selection are disabled.
- Metadata: Edit song language, title, artist, author, key, tempo, time signature, capo and other metadata here. A title is required before saving.
- Song language: Change this song's language here in edit mode, then save it with the song. If the library's language filter would exclude the new language, the app offers to add it to the filter.
- ChordPro source: The raw ChordPro view gives complete access to directives and notation when you need more control than the visual editor provides.
- Online editing rules:
  - Online editing: After signing in you can synchronize and submit new songs or corrections. Changes apply to your own database immediately and reach the public database only after operator approval.
  - 1. Original key: Store songs you did not write in their original key. Use transpose and leader profiles for your performance key.
  - 2. Chord progression: Whenever possible, enter the complete chord progression as well as the lyrics so the shared database remains useful.
  - 3. Existing songs: Do not transpose or rename a database song for personal use. Such a correction is appropriate only when restoring the author's original data.
  - 4. Do not duplicate sections: Describe repeats and performance order with instructions instead of copying song sections.
  - 5. Lyrics only: Keep only lyrics in lyric fields. Put performance directions and notes in instructions.
  - 6. Avoid ellipses: Do not replace repeated line endings with ‘…’; write the complete line or section even when it matches the previous one.
  - 7. Repeated chords: Enter repeated chord progressions at their correct positions. The app can hide them, but cannot infer missing positions.
  - 8. Recognized chord syntax: Use recognized chord notation so transpose and capo work correctly. Report a valid but unsupported chord type to the operator.

## Section list
(full-view, id: full/sections)

The projectable sections of the processed song appear here. Select a section for projection or use checkboxes to omit sections.
- Projection settings: Open detailed projection output settings when this button is present in the current layout.
- Sections: Colors indicate section type and projection mode; the repeat indicator shows the current pass.
- Omit: Uncheck a section to omit it from projection without modifying the database song.
- Keyboard: With the factory mapping and section-list focus, arrows, Page Up/Down, Space, Home and End navigate; number keys select directly and Escape clears selection. Hardware control settings allow custom profiles and keyboard scope.

## Projection switches
(full-view, id: full/projection)

Quick controls for display output, text, image, background, content formatting, instructions, remote control, freeze and message.
- Enable display: Turn the external projection output on or off. It may be limited on a single-monitor system.
- Lyrics: Toggle lyrics on the projection output.
- Background image: Toggle the selected background image on the output.
- Background color: Choose the background color used without an image.
- Content-based formatting: Apply automatic section breaks according to the song's content.
- Instruction-based list: Use performance instructions to build the order shown in the section list.
- Remote control: Allow or block an authorized client from changing projected sections remotely. The tablet activity indicator remains visible while this switch is off; its direct-request timeout is configurable at the end of Projecting settings.
- Freeze: Keep the current output visible while preparing the next content in the app.
- Message: Toggle the short text entered on the Message tab onto the output.

## Format and content
(full-view, id: full/format)

Use the Format, Image, Message and Controls tabs to configure projected appearance and additional content.
- Text format: Set font, size, style, color and alignment. These affect presentation, not the song text.
- Image: Choose a background, fit mode and image-related settings.
- Message: Write a short message here and show it with the separate Message toggle.
- Controls: Projection and display controls appear on this tab; the buttons implement the functions of the keyboard controls available in the section list.
- Panel layout: Cycle through collapsed layouts to give more room to either settings or the preview.

## Projection preview
(full-view, id: full/preview)

Check the exact projected image here. When a shareable address exists, the preview can also show a QR code.
- Rendered output: The preview combines the current section, formatting, background, highlight and message.
- QR code: The QR code's position and size can be adjusted on the preview; a detailed size control is also available.
- Resize area: Use the horizontal divider to change the space allocated to the section list and preview.

## Song view
(client-view, id: client/song-view)

The current song appears here with ChordPro formatting, chords, notation and instructions. Use paging controls to change songs.
- Song content: Appearance follows chord, capo, transpose, theme and zoom settings. In follower mode you see the leader's song.
- Notation and playback: Double-click or double-tap visible ABC notation to start MIDI playback, and repeat to stop. The Zoom panel can show lyrics and chords in place of notation without changing the original song.
- Paging: Paging and the toolbar's previous/next buttons start the same page-turn action.
- Two-finger tap: Tap with two fingers without moving. Modes cycle Off → Fit page → Fit width → Manual, and the new mode briefly appears.
- Zoom modes: Fit page fits the entire song into the available area. Fit width fills the width and keeps longer songs vertically scrollable. Manual uses an explicit font size. Auto wrap is a separate option; fitting may choose a larger font for short songs. A two-finger tap or Ctrl+Shift+wheel cycles modes.
- Pinch zoom: Pinch to reduce or spread to increase font size, or use Ctrl+mouse wheel. While zoom is on, an automatic fit switches to Manual at the current on-screen size, then adjusts from there. With zoom off, these gestures do not change the font size.
- Navigation source: The navigation icon shows whether paging follows the database, search results, the current playlist or a saved leader playlist. If you can control the display and the working playlist contains a song, tap the icon to return to playlist navigation.
- Add song: If a database or search result is not yet in the playlist, add it and switch to playlist navigation here.
- Highlight: In highlight-control mode, select lyrics to highlight them on the leader and permitted follower displays.

## Main toolbar
(client-view, id: client/toolbar)

The toolbar collects quick performance controls. Depending on orientation it can appear at the top or along the side.
- Previous song: Move to the previous song in the current navigation order. It may be hidden while a remote leader controls the display.
- Next song: Move to the next song in the current navigation order. It may be hidden while a remote leader controls the display.
- Return to your own app: Use Home to leave a shared or locked session and return to the app's own interface. Switching to the full editor is a separate action in More where that option is available.
- Instructions: Tap or click briefly to step through: off, without comments → the song's comments as the editor shows them (amber glow; a comment naming a section shows that section's first line) → instructions (blue glow) → off. Hotkeys and hardware buttons switch instructions on and off.
- Instructions editor: With control permission, hold or right-click this button to open the Source, Editor and Preview panes. Saved changes appear immediately. Instructions for the projected song also update the shared display; another locally opened song stays local. Saving empty text clears the instructions.
- Capo: Tap or click briefly to toggle capo. Hold, right-click, use the separate dropdown control or just drag horizontally to choose a capo value directly.
- Transpose: Tap, click or drag horizontally to open the picker and transpose the viewed song by semitones. While controlling the projected song, changes also reach the shared display. Transposing a different song opened locally from the database or a saved list stays local.
- Value picker: Drag, use the visible choices or use the keyboard to step through values; dragging from the transpose or capo control also opens the picker directly. Pressing Enter or clicking a specific value applies that new value; pressing Escape or clicking outside the value picker closes it and restores the original value.
- Clear highlight: This control appears only when the active highlight can be cleared with your current permission.
- Full screen: Switch between full-screen and windowed display.
- Pull to refresh: Pull the toolbar down and release to reload the client view and background data.
- Network status: The icon indicates connection, following, authorized leading or error. Reconnection can be requested from the same control.
- Keyboard and MIDI: Use keyboard controls and, where supported, MIDI. Create custom mappings in full view under Settings → Hardware control. Full and client view have separate profiles; copy the factory profile to edit it and learn inputs.

## Options and lists
(client-view, id: client/options)

Open display settings, search and, with sufficient permission, the playlist here.

## Search and list mode
(client-view, id: client/search)

Search the song database, filter the playlist or switch among database, playlist and leader lists.
- Search and song language: The host app's song-language filter may restrict the available catalogue. Clearing the search does not remove it. In your own app, check the song-language filter in General settings; a followed session supplies the songs offered by its host.
- List mode: If you can edit the working playlist, the button cycles through the song database, the current playlist and leader lists. The icon shows the current mode.
- Search and filter: In database mode it searches songs; in playlist mode it first filters locally. Escape or Clear empties the field.
- Database search: While filtering the playlist, search the complete song database for the same phrase.
- Leader lists: Choose a leader, then a dated or named favorite playlist. Search lists matches song titles across all lists for that leader. Each result shows its source list. Tap a result to select that list. After confirmation, := replaces the working playlist with the entire selected list, leaving the saved list intact.

## Song list
(client-view, id: client/song-list)

Select a row to display a song. In editable mode add it to the playlist or open it directly in playlist navigation.
- Result row: The selected song is displayed and paging continues in result order. The selected row remains highlighted.
- Add: Plus adds the song to the playlist; a check marks existing entries and the same control removes it.
- Show song now: The ▶ button beside a song adds it to the current playlist if needed, displays it and switches paging to playlist order. Double-click or double-tap the displayed notation to start its MIDI playback.
- Match location: The marker shows whether the match came from title, lyrics, header or another field.
- List size: List row size can be adjusted separately by CTRL+mouse wheel or pinch zoom, and the setting persists on this device.

## Current playlist
(client-view, id: client/playlist)

Select and arrange performance songs here, with per-song transpose and capo settings.
- Open song: A playlist row displays the song and subsequent paging follows playlist order.
- Reorder: Rows can be reordered in an editable playlist. Followed and saved source lists remain read-only.
- Transpose and capo: Row controls affect only this playlist entry, not the database song.
- Remove: Drag the row to the removal target to remove it only from the current working list; the database song remains.
- Playlist row size: Playlist row size can be adjusted by pinching or Ctrl+mouse wheel combination and persists on this device.

## Display options
(client-view, id: client/display-options)

Control how chords, highlights, zoom and theme appear on this device.
- Chord display: Choose inline chords, guitar or piano diagrams, or a lyrics-only view; the direct picker offers the same options.
- Minor chord spelling: Choose among Am, am and the available minor-chord spellings.
- Repeated section chords: Hide chords repeated unchanged from the previous section of the same type.
- Subscript modifiers: Show chord modifiers in a smaller indexed style.
- Automatic key: The Ab switch spells chord notes for the key, for example G♯ or A♭ for the same pitch. If the song has no declared key, the app can infer one for display from the chord progression. Use Transpose to change pitch.
- Highlight: A short click or tap toggles highlighting. Hold or right-click to open its opacity setting. A hand icon indicates highlight control; available actions depend on session permissions.
- Note-name system: Switch chord display between the English ABCDEFG and Hungarian/German AHCDEFG note-name systems.
- Chord simplification: Hide some complex chord modifiers for a clearer display.
- Zoom: A short click or tap toggles zoom. Hold or right-click to open the detailed zoom panel.
- Zoom panel: Control title, metadata, section labels, notation and auto wrap separately. Choose a sizing mode; Manual shows a font-size slider. Changes apply immediately on this device.
- Notation or lyrics and chords: With zoom enabled, the ♪ button switches between full notation and lyrics/chords derived from it. Instrumental notation may become a chord grid; unsupported scores retain notation. The original song is unchanged.
- Auto wrap: The wrap icon separately enables wrapping long lines; blue highlighting marks it as active. Fit width remains scrollable for long content, and Manual preserves the selected font size.
- Section labels: Cycle between full section labels, abbreviations and hidden labels. This changes this device's display without editing the song's stored section names.
- Theme: Cycle among automatic, light and dark appearance.
- Leader mode: Where supported, switch between follower and leader. A leader can modify shared display state.
- Close: Close options panel and return to the full song view.

## More actions
(client-view, id: client/more)

Depending on mode, More contains clear list, sessions, switch UI, about and exit.
- Attention badge colors: Dots on Options, More and Switch UI report host-app tasks: green for upload, blue for download, turquoise for both, and orange for offline. Red can indicate song review, an update or a new sign-in. Cloud database synchronization is available in full view.
- More menu: Only actions available in the current runtime and mode are shown.
- Clear list: After confirmation, remove entries from the working list without changing its saved source.
- Sessions and connection: Open the hub for discovering, starting and following connections. It manages local, nearby and cloud sessions, can provide a sharing QR code, and lets you return to your own lists while following. The main toolbar network indicator shows the current connection state.
- Back to full view: Open More in client view and choose Switch UI, where available. When the client view is open inside the full app, the full view takes over the selected song. In the built-in tutorial, Return to full view continues the tour there.
- About: Shows app version, licenses and device information. You can restart this tutorial here at any time.
- Exit: Close the program in a native application runtime.

## Toolbar buttons
(buttons, id: buttons/toolbar)

- Synchronize database with server
- Create new song
- Delete song from database
- Reload song from database
- Save song to database
- Import song
- Import multiple songs from folder
- Print actual song
- Settings
- Manage sessions
- Switch to mobile view
- Open logs

## Playlist buttons
(buttons, id: buttons/playlist)

- Load playlist from file
- Save playlist into file
- Add selected song to playlist
- Remove selected item from playlist
- Move playlist item down (Ctrl+Down)
- Move playlist item up (Ctrl+Up)
- Edit playlist item title
- Transpose playlist item half note higher (Alt+Up)
- Transpose playlist item half note lower (Alt+Down)
- Raise recommended capo value of playlist item
- Lower recommended capo value of playlist item
- Load a playlist from the leader's calendar or favorites
- Save the playlist into the leader's calendar or favorites
- Click to select and project a song.
Drag to reorder.
Right-click for transpose, capo and more options.

## Format tab buttons
(buttons, id: buttons/format)

- Bold
- Italic
- Underline
- Left align
- Center align
- Right align
- Select text color
- Select background color
- Toggle content based text formatting

## display (buttons)
(buttons, id: buttons/display)

- Switch between available screens
- Only one monitor detected — connect a second screen to project
- Toggle lyrics visibility
- Toggle image visibility
- Allow or block authorized clients from changing the projected section
- Switch between message and lyrics
- Toggle freezed state
- Toggle instructions based section list

## editor (buttons)
(buttons, id: buttons/editor)

- Switch readonly state
- Save actual song as new
- Transpose all chords a half note higher
- Transpose all chords a half note lower
- Set selected lines Verse
- Set selected lines Chorus
- Set selected lines Bridge
- Set selected lines Grid (instrumental)
- Toggle selected lines as comments (unavailable when they contain chords)
- Insert ABC notation at the cursor. Double-click an existing ABC block to edit it.
- Set selection as title

## instructions (buttons)
(buttons, id: buttons/instructions)

- Clear
- Reset
- Save
- Store instructions in leader profile

## Song filters and preferences
(buttons, id: buttons/song)

- Filter songs by title or content
- Showing preferred and neutral songs
- Showing preferred only
- Showing all including ignored
- Clear filter
- Neutral
- Preferred
- Ignored

## section (buttons)
(buttons, id: buttons/section)

- Check all sections for projection
- Uncheck all sections
- Select previous section
- Select next section

## preview (buttons)
(buttons, id: buttons/preview)

- Move next marker to first selectable section (Home)
- Move next marker to previous song block (Page Up)
- Move next marker up (Up Arrow)
- Jump to start of current song block (Backspace)
- Move next marker to last selectable section (End)
- Move next marker to next song block (Page Down)
- Move next marker down (Down Arrow)
- Project next section or advance repeat (Enter)
- Rotate preview panel layout
- controls + preview
- preview only
- controls only
- both collapsed
- Click to show a QR code on the projected display.
Viewers can scan it with their phone
to follow along on their own screen.
- Drag to move · Scroll to resize · Click to hide

## settings (buttons)
(buttons, id: buttons/settings)

- Save changes and close
- Discard changes and close
- Apply changes without closing

## Using the song library
(buttons, id: buttons/songtree)

- Browse and search your song library.
Select a song to load it in the editor.
Double-click a song to add it to the playlist and project it immediately.
Right-click for more options.

## Using the section list
(buttons, id: buttons/sectionlist)

- Click to project the section.
Colors indicate current/next section
and whether the section fits on the screen with current settings.
* Enter - jump to next section
* Arrows - move next section up/down
* Page keys - switch song block
* Backspace - jump to beginning of song block
* Esc - clear selection

## imagelist (buttons)
(buttons, id: buttons/imagelist)

- Expand image list
- External image from folder

## Resolving sync differences
(buttons, id: buttons/dbsync)

- Double-click to view or resolve
