# How to migrate from OnSong to Fretlist

> A step-by-step guide to exporting your songs and setlists from OnSong and importing them into Fretlist.

Source: https://fretlist.com/docs/import-from-onsong

Want your OnSong songs on a Windows laptop, in any browser, or in a simpler app? You don't have to re-enter hundreds of songs to switch. Fretlist imports your OnSong songs and setlists in one go.

## What gets imported

- **Songs**: lyrics, chords, ChordPro formatting, section headers
- **Metadata**: title, artist, key, capo, duration. If a text song's chords point to a key, Fretlist uses that key. Tempo and time signature come across when they are written as directives in the song text.
- **Setlists**: recreated in the same order. A song that could not be imported is left out, and the summary names it.
- **Attachments**: the text of PDF and Word files in the backup becomes the song, with the title, key, capo and artist OnSong stored for it. Scanned PDFs, sheet music (notes on a staff), image attachments and PDFs over 10 pages don't come in: the summary lists them, and you can paste the chords and lyrics in yourself.

## Step 1: Export from OnSong

1. Open the **Utilities** menu → **Backup**
2. Pick a destination, name the file, and save. AirDrop the resulting `.backup` to your Mac, send it to iCloud/Google Drive, or email it to yourself

## Step 2: Import into Fretlist

1. Log in to [the app](https://fretlist.com/app): the dashboard has a big dropzone right there
2. Drop your `.backup` file onto it. Fretlist auto-detects the format, no need to pick anything
3. Fretlist shows the totals: songs and setlists detected. Optionally skip setlists, then hit **Import**

The backup imports as-is. Songs save in batches and setlists are linked to the newly imported songs automatically. PDF and Word attachments are extracted and processed server-side.

## Clean up duplicates

After a big import, libraries can get messy. **Settings → Matching titles** finds songs that share a title and shows them side-by-side so you can keep the version you want and drop the rest.

## After the import

- **Works everywhere**: phone, tablet, laptop, any browser
- **Instant transpose**: change key with one click
- **Play Mode**: distraction-free full-screen view for the stage
- **Auto-scroll**: hands-free scrolling at adjustable speed
- **Offline access**: your library is cached for gigs without Wi-Fi

Open a setlist, hit Play, and you're performing.

> [Try Fretlist for free](https://fretlist.com): your songs and setlists, on any device, ready for the stage.

## Related docs

- [Import from SongbookPro](https://fretlist.com/docs/import-from-songbookpro.md): migrate your SongbookPro library into Fretlist
- [Import from Ultimate Guitar](https://fretlist.com/docs/import-from-ultimate-guitar.md): bring songs across one at a time with a simple copy/paste

## Related reading

- [OnSong for Android: what to use instead](https://fretlist.com/blog/onsong-for-android-what-to-use-instead.md): what OnSong's Android app gives you, and when Fretlist fits better
- [Fretlist vs OnSong: the full comparison](https://fretlist.com/alternative/onsong)

---

- [Fretlist vs OnSong: the full comparison](https://fretlist.com/alternative/onsong)
