View source for Song Import

== Song import ==

JustChords provides several ways to import new songs into your Library so you can choose the method that best fits your workflow.

== Import from online search ==

The fastest way to add songs is via the built-in online search.

=== 1. Online Song Search ===

; How it works

The imported song is stored in your Library and can be edited and transposed like any other song.

Adding the songs you like is easy.
# Tap/Click '''Add song'''
# Tap/Click '''Search online'''  [[File:add-song-justchords.png|frameless]]
Use the search Textbox to type the song title (and optionally artist).
# Type '''Let It Be''' or any song title you like. (JustChords queries its known online chord resources and shows a list of matching songs.)
# Tap/Click on the search result to see a preview of the chord sheet  [[File:search-online-justchords.png|frameless]] 

Select the desired entry from the results and tap '''Import''' to add the song to your Library.
# Tap/Click '''Import''' to store the chord sheet in your songs library
# Tap/Click '''✓''' to close the dialog
You have successfully imported the chord sheet. 
[[File:let-it-be-guitar-justchords.png]]

=== 2. External song pages (e.g. SongSelect) ===

For external sites such as CCLI SongSelect you can configure JustChords to open them directly in an in‑app browser (WebView).

; Setup
: Add the external domain (for example the SongSelect URL) to JustChords once.
: This creates an entry that you can reuse later to open that site inside the app.

; Usage
: Choose the external source entry in the online search section.
: JustChords opens the site in an in‑app WebView, where you can log in and navigate to the desired song.
: On the external site, download the ChordPro file for the song (note: services such as SongSelect may require a valid license for specific downloads).
: When the ChordPro file is opened, JustChords shows an '''Import''' button in the top‑right corner of the WebView.
: Tap '''Import''' to pull the song content into your Library as a normal, editable song.

This flow lets you stay inside JustChords while using licensed external catalogues.

== Manual entry ==

If you prefer full control, you can create a song completely by hand.

; How to create
: Tap '''Add song'''.
: Choose '''Manual entry'''.
: Enter title, metadata, lyrics and chords directly in the Song Editor.

This is useful for original songs, arrangements that do not exist online, or when you want to follow your own formatting conventions from the start.

== Create song from clipboard ==

If you already have a song text (ideally in ChordPro format) copied to your device’s clipboard, you can turn it into a song in one step.

; How to use
: Copy the song text to the clipboard (for example from a website, email or notes app).
: In JustChords, choose the option to create or import a song from clipboard.
: JustChords creates a new song and opens it in the Song Editor.

When the clipboard content is valid ChordPro, the newly created song is immediately transposeable and ready for use in projection and setlists.

== Import from file (including bulk import) ==

You can also import songs from files stored locally or in cloud storage.

; Supported formats
: ChordPro files
: PDF files
: SongbookPro files
: OnSong files
: JustChords song files

; How to import
: Choose '''Import from file'''.
: Select one or more files in the supported formats.
: Confirm to start the import.

Multiple files can be selected at once, so bulk import of entire song collections is possible in a single operation.

=== ChordPro files with multiple songs ===

If a ChordPro file contains multiple songs, make sure of the following:

* Before each new song, insert the directive:
  `{new_song}`
* Each song must have a unique title defined with:
  `{title: Song title}`

This allows JustChords to correctly detect and split multiple songs within a single ChordPro file.

=== PDF files ===

When you import a PDF file, JustChords creates a new song with the PDF attached to it.

* The PDF becomes part of the song and can be opened directly from within JustChords.
* This is useful for scanned lead sheets or scores that are not available in text or ChordPro format.

== Licensing and responsibility ==

For all import methods (online search, external pages, ChordPro, PDF and other formats), please note:

* JustChords does not distribute, sell or license any copyrighted content.
* The user is fully responsible for complying with the terms of use and licensing of any content that is imported, such as song lyrics or chord sheets downloaded from the web.
* Not everything that can be found online and is advertised as “free download” is in fact free of licensing or copyright restrictions.

Always check the licensing situation and make sure you have the appropriate rights to use and project any imported material.