GigScroll User Guide

1. Getting Started

Welcome to GigScroll!

GigScroll is a professional lyrics teleprompter designed specifically for live performers. Whether you're playing a coffee shop or a stadium, GigScroll keeps your lyrics front and center with smooth auto-scrolling, customizable fonts, and stage-ready themes.

First Launch

When you first open GigScroll, you'll see a quick tutorial covering the basics. You can always view it again from Settings → Show Tutorial Again.

The Main Interface

GigScroll has three main tabs at the bottom:

• Songs - Your complete library of songs with search
• Setlists - Organized song collections for performances
• Settings - Themes, fonts, and data management

2. Managing Your Songs

Adding Songs

There are two ways to add songs to your library:

Option 1: Search Online for Lyrics

1. Tap the + button in the top-right corner
2. Start typing a song title or artist name
3. As you type, you'll see autocomplete suggestions from iTunes
4. Select a suggestion, and GigScroll will automatically search for lyrics from multiple sources
5. Review the lyrics and tap Save

Option 2: Add Manually

1. Tap the + button
2. Enter the song title and artist (optional)
3. Paste or type the lyrics in the large text area
4. Tap Save

Editing Songs

To edit a song's lyrics, title, or settings:

1. Tap on any song in your library
2. Make your changes (all changes auto-save)
3. Tap the back button when done

Searching Your Library

Use the search bar at the top of the Songs tab to quickly find songs by title or artist. The search filters as you type.

Recent Songs

Your most recently performed songs appear at the top of the Songs tab for quick access.

Deleting Songs

To delete a song, swipe left on it in the Songs list and tap Delete.

3. Building Setlists

What is a Setlist?

A setlist is an ordered collection of songs for a specific performance or gig. Setlists make it easy to flow through your songs in order without searching during a performance.

Creating a Setlist

1. Go to the Setlists tab
2. Tap the + button
3. Enter a name (e.g., "Saturday Night at Joe's Bar", "Worship Set - Dec 10")
4. Tap Create

Adding Songs to a Setlist

1. Tap on a setlist to open it
2. Tap the + button in the top-right
3. Select songs from your library
4. Tap Done

Reordering Songs

1. Open a setlist
2. Tap Edit in the top-left
3. Drag songs using the handle (≡) on the right side
4. Tap Done when finished

Removing Songs from a Setlist

Swipe left on any song in the setlist and tap Delete. This only removes the song from this setlist - it stays in your library.

Deleting a Setlist

To delete an entire setlist, swipe left on it in the Setlists tab and tap Delete. The songs remain in your library.

Sharing a Setlist

Share a setlist with bandmates or other performers:

1. Open the setlist
2. Tap the Share button (square with arrow)
3. Choose how to share: AirDrop, Messages, Email, Files, etc.

The recipient can open the file in GigScroll to import your setlist with all the songs!

4. Performance Mode

Starting a Performance

There are two ways to enter performance mode:

Option 1: Single Song

1. Open any song from the Songs tab
2. Tap the large PLAY button

Option 2: Full Setlist

1. Open a setlist from the Setlists tab
2. Tap the large ▶ PLAY SETLIST button

Performance Mode Controls

Once in performance mode, you'll see your lyrics in large text with controls at the bottom:

Auto-Scrolling

The lyrics automatically scroll from bottom to top at your chosen speed. The scrolling is smooth and optimized for stage visibility.

Adjusting Scroll Speed

• Tap + to make it scroll faster
• Tap - to make it scroll slower
• Tap the 💾 button to save your preferred speed for this song

Navigating During Performance

When playing a setlist, you can:

• Tap Next ▶ to advance to the next song
• Tap ◀ Previous to go back to the previous song
• The position indicator (e.g., "2/5") shows where you are in the setlist

Manual Scrolling

You can also scroll manually by swiping up or down on the lyrics. Auto-scrolling will pause when you manually scroll.

Exiting Performance Mode

Tap the X or Done button in the top corner to exit back to the song editor or setlist.

5. Customization

Choosing a Theme

GigScroll offers four themes optimized for different lighting conditions:

To change themes:

1. Go to Settings → Theme
2. Tap on your preferred theme
3. The change applies immediately

Selecting a Font

Choose from 5 fonts optimized for readability:

• System - Apple's San Francisco font (default, excellent readability)
• Georgia - Serif font with classic elegance
• Helvetica Neue - Clean, modern sans-serif
• Courier - Monospace font, typewriter style
• Arial Rounded MT Bold - Friendly, rounded letters

To change the default font:

1. Go to Settings → Default Font
2. Tap on your preferred font
3. This font will be used for new songs

Adjusting Font Size

Font size can be set globally and per-song:

Default Font Size (for new songs)

1. Go to Settings → Default Font Size
2. Choose a size from 24pt to 72pt
3. Choose whether to apply to existing songs or just new ones

Per-Song Font Size

1. Open any song in the Songs tab
2. Use the font size slider to adjust (24-72pt)
3. Changes auto-save

Scroll Speed Per Song

Each song can have its own scroll speed:

1. Open a song and tap PLAY
2. Use the + and - buttons to adjust speed
3. Tap the 💾 button to save that speed for this song

Ballads typically need slower speeds, while uptempo songs need faster scrolling.

6. Data Management

Export All Songs & Setlists

Create a complete backup of your library:

1. Go to Settings → Data Management → Export All Songs & Setlists
2. Choose where to save: Files app, AirDrop, email, cloud storage, etc.
3. A file named GigScroll-Backup-YYYY-MM-DD.gigscroll will be created

Import from File

Restore a backup or import someone else's songs/setlists:

1. Go to Settings → Data Management → Import from File
2. Select a .gigscroll or .json file
3. Review the import preview showing what will be imported
4. Tap Import

Duplicate Handling

If songs in the import file already exist in your library, GigScroll automatically skips them to prevent duplicates.

Sharing Individual Setlists

Share a setlist with your band or other performers:

1. Open the setlist
2. Tap the Share button (square with arrow)
3. Choose AirDrop, Messages, Email, or save to Files

When the recipient opens the .gigscroll file, it will automatically import the setlist and all its songs into GigScroll!

Restore Purchases

If you purchased GigScroll Pro and need to restore it on a new device:

1. Go to Settings → Restore Purchases
2. Sign in with the same Apple ID you used to purchase
3. Your Pro features will be restored

7. Pro Features

Free vs Pro

GigScroll is free to try with a limit of 10 songs. Upgrade to GigScroll Pro for unlimited songs and support ongoing development!

Upgrading to Pro

1. Go to Settings
2. Tap ⭐ Upgrade to Pro at the top
3. Review the benefits
4. Tap Purchase
5. Complete the purchase with Face ID/Touch ID/Password

Pro Status Indicator

Once you upgrade, you'll see "Pro Unlocked ✓" in Settings, and the upgrade banner will disappear.

8. Tips & Tricks

For Live Performance

• Practice setlist navigation - Get comfortable with the Next/Previous buttons before your gig
• Test lighting conditions - Try different themes at your venue during soundcheck
• Position your iPad securely - Use a music stand or iPad mount
• Bring a charger - Performance mode keeps the screen on continuously
• Have a backup - Print your setlist or have it on your phone as a fallback
• Disable notifications - Turn on Do Not Disturb before performing

Building Your Library Efficiently

• Start with your most-played songs - These get the most benefit from auto-scrolling
• Use online search first - It's faster than typing lyrics manually
• Add songs after practice - Make it a habit to add new material right away
• Create setlists by venue - Saves time when booking repeat gigs
• Share with your band - Everyone can have the same library by importing setlists

Organizing Your Content

• Use consistent naming - "Venue Name - Date" for gig-specific setlists
• Add artist names - Helps with searching and looks professional
• Clean up old setlists - Delete one-time gig setlists after they're done
• Create master setlists - "All Country", "All Rock", etc. for quick building

Maximizing Readability

• Bigger is better on stage - Start with 44pt and adjust from there
• Stage theme for bright lights - White-on-black has maximum contrast
• Dark theme for dim venues - Reduces eye strain in clubs and bars
• Keep your screen clean - Smudges kill readability under stage lights
• Experiment with fonts - Georgia and Helvetica are very readable

Speed Optimization

• Ballads - Usually need speed around 0.5-1.0x
• Medium tempo - Speed around 1.0-1.5x works well
• Fast songs - May need 1.5-2.5x or more
• Spoken word/rap - Often need higher speeds (2.0-3.0x)
• Save speeds per song - Use the 💾 button after you find the perfect speed

9. Troubleshooting

Lyrics Not Found

Problem: Online search can't find lyrics for my song.

Solutions:

• Try searching with just the artist name (sometimes this helps)
• Check your spelling of the title and artist
• Try searching for an alternate version (live, acoustic, remix)
• Some songs simply aren't in the databases - add them manually
• Very new songs may not be indexed yet

Import Not Working

Problem: I can't import a backup file.

Solutions:

• Make sure the file has .gigscroll or .json extension
• Verify the file isn't corrupted (re-export if needed)
• Check that you're on the latest version of GigScroll
• Free tier users: Check if importing would exceed the 10-song limit
• Try importing on WiFi instead of cellular (better for large files)

Scrolling Too Fast/Slow

Problem: The auto-scroll isn't matching my song tempo.

Solutions:

• Use the + and - buttons to adjust in real-time
• Remember to tap the 💾 button to save your preferred speed
• Each song can have a different scroll speed
• If it's jumping around, try pausing and resuming to reset

Can't Read Text on Stage

Problem: I can't read the lyrics during performance.

Solutions:

• Switch to Stage theme (highest contrast)
• Increase font size to 52pt or higher
• Increase screen brightness to 100%
• Clean your iPad screen thoroughly
• Move your iPad closer (optimal: 2-3 feet away)
• Angle the screen away from direct stage lights to reduce glare

App Crashes During Performance

Problem: GigScroll crashes or freezes on stage.

Solutions:

• Update to the latest version of GigScroll
• Restart your iPad before the gig
• Close other apps to free up memory
• Turn off Background App Refresh for other apps
• Make sure you have at least 1GB of free storage
• As a backup, export your setlist and keep it in Notes app

Battery Draining Quickly

Problem: My iPad battery dies during long sets.

Solutions:

• Performance mode keeps the screen on - this is normal
• Bring a charger and plug in during breaks
• Use a battery pack if no outlet is available
• Reduce screen brightness if the venue is dark
• Close all background apps before performing
• Enable Low Power Mode (Settings → Battery)

Still Need Help?

If you're experiencing issues not covered here, please contact support:

• Email: support@moonquakemedia.com
• Include: iOS version, iPad model, description of the issue
• Screenshots are helpful if possible!