> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bgms.live/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about using BGMS

# Frequently Asked Questions (FAQ)

Common questions about using BGMS.

## Search Related

### Search doesn't work

You need to set up Google Access Token to use the search function.

👉 [Set up Search Function](https://docs.bgms.live/en/search.md)

### Can I add music without search?

Currently, you cannot add music without Google Access Token. The YouTube URL direct input feature is under development.

👉 [Set up Search Function](https://docs.bgms.live/en/search.md)

## Invitation Related

### Invitation email didn't arrive

Please check:

* Verify you invited with Gmail account
* Check spam folder
* If Google Workspace, check admin settings

### Can I invite with non-Gmail emails?

No, BGMS only supports Gmail and Google Workspace accounts.

## Channel Related

### How many channels can I create?

You can create up to **3 channels**.

### How do I delete a channel?

You can find the delete option in channel settings.

### What is a Ghost Channel?

A Ghost Channel is a **frozen state** that occurs when the channel owner leaves the channel.

When a channel becomes a Ghost Channel, member management features like invitations and playlist additions/deletions are restricted, but existing members can still enjoy content through the player.

> [!WARNING]
>
> Once a channel becomes a Ghost Channel, it cannot be recovered.

### What happens when all members leave a channel?

If all existing members leave the channel, the channel will be deleted. Please be careful!

## Playback Related

### Are there really no ads?

Yes! YouTube music played through BGMS doesn't show mid-video ads. (Banner ads at the bottom may still appear)

### What happens when multiple people add music simultaneously?

They're added to the playlist in order. Like a jukebox, everyone can enjoy music together!

## Troubleshooting

### Music won't play

**Please check the following:**

1. **Verify Google Access Token**
   * Confirm that Google Access Token is set up correctly
   * Check if token expiration hasn't passed
   * See [Set up Search Function](https://docs.bgms.live/en/search.md) to reconfigure

2. **Check internet connection**
   * Verify Wi-Fi or mobile data connection status
   * Try reconnecting if connection is unstable

3. **Clear browser cache**
   * Delete browser cache and cookies
   * Refresh the page

4. **Try on a different device**
   * Sign in with the same account on another device to test
   * This helps identify if the issue is device-specific

**If these steps don't resolve the issue, please contact [cs@bgms.live](mailto:cs@bgms.live).**

### "This video can't be played" error

**Why this error occurs:**

* YouTube has restricted playback of that music (geographic restrictions, licensing issues, etc.)
* The music has been deleted from YouTube
* Your YouTube account has playback restrictions

**Solutions:**

1. **Find an alternative version**
   * Try searching for the same song by a different uploader
   * Look for the music on the artist's official channel

2. **Re-login to your account**
   * Reset your Google Access Token
   * Log in to your account again

3. **Check VPN usage**
   * If using a VPN, try disabling it before playing
   * Geographic restrictions may be the cause

**If only specific songs produce this error, try playing other music.**

### Invitation email didn't arrive

**Things to check:**

1. **Check spam folder**
   * Look in Gmail's spam/junk folder
   * Check other mail tabs in Gmail

2. **Check email filters**
   * Go to Gmail Settings > Filters and Blocked Addresses
   * Look for [cs@bgms.live](mailto:cs@bgms.live) or related domains
   * Delete any blocking filters

3. **Google Workspace admin settings**
   * If using a company Google Workspace account, ask admin if email reception is restricted
   * Your admin may have restricted incoming emails from external sources

4. **Request invitation again**
   * Ask the channel owner to resend the invitation
   * Wait a few minutes and check again

**If emails still don't arrive, contact [cs@bgms.live](mailto:cs@bgms.live).**

### Multiple people controlling at the same time seems chaotic

**This is expected behavior!**

BGMS is designed as a jukebox system:

* **Simultaneous additions**: When multiple people add music at the same time, they're queued in the order they were added
* **Sequential playback**: When one song ends, the next one automatically starts playing
* **Fair system**: Everyone gets to enjoy music equally

**What to expect:**

1. User A adds Song 1 (now playing)
2. User B adds Song 2 (waiting)
3. User C adds Song 3 (waiting)
4. Song 1 ends → Song 2 plays → Song 3 plays

**This is the intended design, so if you think "control is getting chaotic," check if other users are adding music.**

### Channel permissions explained

**Owner permissions:**

* Modify channel settings
* Invite and remove members
* Add and delete playlists
* Delete the channel

**Member permissions:**

* Search and add music
* View currently playing music
* View playlists
* Cannot manage members or change settings

**Having permission issues?**

1. **Verify your role**
   * Check your role in the channel (Owner or Member)
   * Contact the owner if you need different permissions

2. **No owner available (Ghost Channel)**
   * Ghost channels have most features restricted
   * See [Ghost Channel information](https://docs.bgms.live/en/faq.md#what-is-a-ghost-channel) for details

**If you need permission changes, ask your channel owner.**

## Technical Support

### I have more questions

Please contact [cs@bgms.live](mailto:cs@bgms.live).

## Feature Suggestions

### I want to suggest a new feature

Send feature suggestions to [cs@bgms.live](mailto:cs@bgms.live)!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.