🏠 Room Management Guide

✉️ Inviting People

An invite is a link that takes someone straight into a room, even a private, hidden, locked or password room. You choose who can use it, how long it lasts and how many times it works.

Create an invite

1. Sign in. Share on a room (room card or room header) now makes an invite too, so everyone you share with gets an official VoiceLink invite. In a room, you can also choose Invite people in the room header. From the room list, open a room's Actions menu and choose Invite people. Admins can also use Admin, Invites, Create invite, which can invite to the whole server.
2. Person to invite is optional. Type their VoiceLink username or email. If they already have an account on this server they also get a notification and a VoiceLink direct message ("You've been invited to General Chat by Dom"), and only they can use that invite. Leave it blank to make a link you can share with anyone.
3. Under Who can use the link, choose "Anyone with the link, as a guest or signed in", or "Only people with a VoiceLink account".
4. Choose when the link expires and how many times it can be used (once by default), and add a message if you like.
5. Choose Create invite, then Copy link (or Share link where your browser offers it). Email them an official VoiceLink invite is ticked by default: the invite is emailed to the address you typed, or to the account email of the person you named. Untick it to make a link only. If no email goes out, the dialog says why (for example, they chose not to get invite emails).

Room owners, room managers and server admins can invite to any room they run. Other signed-in members can invite people to open public rooms, if the server admin allows it. Only server owners and admins can invite people to the whole server. Every room also has a room code: Copy Room Link and Copy Room Code are available for every room, including hidden rooms. Paste either into Search or Join Room to preview the room before joining.

What an official invite says

Invites come from VoiceLink itself: a VoiceLink notification in the app, and an email from the server's own address (for example services@voicelinkapp.app). Both say:

• that it is VoiceLink, and which server (its name and address) and who owns it,
• the room, who the invite is for, and who sent it,
• the sender's message, if they wrote one,
• the invite link, how long it works, and how to open it: in a web browser, in the VoiceLink app on Mac or iPhone, or by getting the app (Mac and Windows downloads, iPhone TestFlight).

Each email ends with a link to stop invite and file emails from that server to that address. People with an account can choose for themselves under Notifications, Notification choices: invite notifications, invite emails, file notifications and file emails. One person can send at most 20 invite and file emails an hour by default.

Invite links

Opening the link first shows a confirmation screen: the server's name and owner (verified or not), location, description, how many people and rooms it has, whether VoiceLink has verified it, its identity fingerprint, who invited you, to which room, when the invite expires and whether the room has a password. Choose Continue to join, Not now (or Escape) to leave without joining, or Report to tell the server's owners and admins privately. If you are signed in to the web app, an invite sent to your account opens the same screen in the app, with no browser link. See Joining with an invite.

After Continue, the join screen says who invited you and to which room, then joins that room when you choose Join Room. If the invite needs an account, you sign in or sign up first and then go straight to the room. Someone who signs in and accepts an invite to a private room can come back to that room later without the link. Bans and the room's size limit still apply.

Who is told

• In the room: by default the room chat shows a system line such as "Matt joined the room, invited by Dom."
• The person who sent the invite is told privately in their notifications: "Matt accepted your invite and joined General Chat."
• Server owners and admins are told privately in their notifications as well.
• Choose Notifications next to your name on the main screen to read your notifications, including ones that arrived while you were away. Direct messages sent while you were offline are delivered when you next sign in.

Admin, Invites

Server owners and admins choose what happens in Admin, Invites:

• In the room: post the "invited by" system line (on by default). When off, the room shows the ordinary "joined the room" line.
• The person invited: send a notification, and a VoiceLink direct message with the link (both on by default).
• The person who sent the invite: tell them in their notifications (on), and also by direct message (off).
• Server owners and admins: tell them privately in their notifications (on), and also by direct message (off).
• Who can invite and how: invites on or off, members inviting to public rooms, guest invites, iPhone push where this server has push set up, and emailing the person invited (on by default).
• Server owner name shown in invites (empty uses the owner account's name), and how many invite and file emails one person can send an hour.
• Default link limits: how long links last and how many times they work.

The same tab lists every invite on the server with who made it, who it is for, its status (not used yet, used, expired or cancelled) and who used it. Each open invite has Copy link and Cancel invite. Members see the invites they made.

⚙️ Managing Your Rooms

🎵 Room Background Media

A room can play music or a radio stream under the voices. The server plays it and mixes it into the room's live audio, so everyone (guests, web, iPhone, iPad, Mac and Windows) hears the same song at the same moment. It automatically gets quieter while people talk, and only plays while someone is listening.

• Who can control it: server admins and the room owner, plus anyone the owner allows in the room's Jellyfin access settings. Guests can listen only.
• What it can play: songs, albums, artists and playlists from the server's Jellyfin music library, or one of the server's radio streams.
• Controls in the web app: the "Background media" section in the room has Previous, Play or Pause, Next and Stop, settings (shuffle, repeat, level for everyone, listener requests), a music library browser with search, and the queue.
• Your own level: everyone can use "Background media volume" and "Mute background media" to change what they hear, without affecting others.
• Listener requests: when turned on, signed-in listeners can request songs (up to 5 waiting each).
• Jukebox categories: each room can have a category (Lounge, Chill, Late night, Gaming, Quiet study, or Talk with no music). New rooms get one from their name. With category music on, the server picks matching songs by itself. Room owners and managers change it with the "Jukebox settings" button in the Background media section; server admins can also create, edit and delete categories there. See Jukebox categories.
• Limits: a few rooms at a time (3 by default); when the server is busy it waits and starts by itself.

Full guide, including the protocol for app developers: Room Background Media.

Finding rooms: search and filters

Each server's room list has a search field and filters. They help you find a room quickly on a busy server.

• Search: type any words. VoiceLink matches the room name, description, category, type, keywords, language and server name. Every word must match, in any order. For example, "music chill" finds a room called "Chill Music Lounge".
• Category: Social and hangout, Music, Gaming, Education and classes, Study and focus, Technology, Creative and arts, Help and support, Wellness and mindfulness, Radio and broadcast, Work and meetings, Community and events, Languages and culture, Entertainment and fun, Books and reading, or Sports and fitness.
• Type: Public, Private, Broadcast, Class, Meeting or Event.
• Keyword: the short tags the room owner gave the room.

Each filter shows how many rooms match each choice. After a search, the number of results is announced. Filters work on one server at a time. To search every server at once, use Federated Rooms, below.

You only ever see rooms you are allowed to see. Private rooms stay hidden unless you have access.

Federated Rooms

Federated Rooms is one flat list of rooms from this server and other VoiceLink servers. There are no server groups to open. Each row reads the room name, the server name, how many people are in it, how many agents are in it, and whether it is locked or needs a request to join.

Search and filter

Use the search field to find rooms by any words. Use the filters for category, type and server. The number of results is announced after each search. The same server reached by more than one address is only listed once.

Room details

Choose a row to open its room details. The details include:

• the description, category, type and keywords;
• the welcome message, the server's message of the day and its rules;
• whether guests can talk, and what music is playing;
• the room owner, the server name and the server owner.

Join is the default action

Join is the first and default action for a room. Preview and the other actions come after it.

• Web: press Enter on Join.
• Mac: press VO-Space on the room, or Return.
• iPhone and iPad: double tap the room.
• Windows: press Enter on the room.

Use Preview to listen before joining. Press Escape, or use Back, to close room details.

Rooms on another server

Each room belongs to one server. When you join a room on a different server, VoiceLink connects you to that server first. In the web app, the other server's own web app opens with that room. On Mac, iPhone, iPad and Windows, the app switches to that server and joins the room.

A room that says "request to join" is private. Joining sends a request to the room's managers. You get in when they approve it.

Room category, type and keywords

Every room has a category, a type, keywords and a language. They are used by search, the filters and Federated Rooms. You set them when you create or edit a room.

• Category: choose one from the list, for example Music or "Study and focus".
• Type: Public, Private, Broadcast, Class, Meeting or Event.
• Keywords: up to 12 short words, separated by commas. For example: jazz, vinyl, chill.
• Language: the main language spoken in the room. The default is English.

If you leave the category empty, VoiceLink picks one from the room name and description. Rooms that already existed were given a category and type the same way. You can change them at any time.

Rooms added from a room template start with the template's category, type and keywords. You can change them afterwards.

A new room's jukebox category comes from its room category. For example, a "Study and focus" room starts with Quiet study music, a Gaming room with Gaming music, and a "Help and support" room with Talk, which plays no music. You can change it in "Jukebox settings". See Room Background Media.

Two rooms on the same server can't have the same name. If the name is taken, you are asked to choose another.

Show in federated rooms

"Show in federated rooms" is a setting on each room. When it is on, the room appears in Federated Rooms on other VoiceLink servers. It is in the room's create and edit settings.

• Server admins can change it on any room.
• Room owners can change it on their own rooms only if the server admin allows it. If not, the setting is shown but can't be changed, and it says why.
• Private rooms and rooms with a password or PIN are hidden from other servers. The server admin can choose to list them as "request to join" instead.
• Other servers never receive a room's password, PIN, allow list or anyone's email address.

For server admins: Federated rooms listing

Open Admin, then Federation, then "Federated rooms listing". These settings decide which of your rooms other servers can see. The server enforces them, whatever app is used.

• Listing enabled: turn this on to list your rooms in the VoiceLink federated directory. When it is off, no rooms are shared.
• Room owners can list their rooms: No one, All room owners, or Selected users and roles. For selected, add user names, email addresses or roles.
• Private rooms: Hide, or show as "request to join". This also covers rooms with a password or PIN.
• Show all public rooms in federated rooms: a one-time action that turns on "Show in federated rooms" for every public room at once.

The settings screen shows how many rooms you have, how many are set to show, and how many other servers can actually see.

Hidden rooms, disabled rooms, expired rooms and private call rooms are never listed.

For server admins: Room templates

Open Admin, then Modules, then "Room templates". This is a catalogue of about 30 ready-made rooms. Examples are Lounge, Coffee Chat, Game Night, Study Hall, Book Club, Support Desk, Assistive Tech Corner, Meditation and Team Meeting. Templates are grouped into packs.

1. Browse the list. Each template shows its category and description.
2. Choose Preview to see the room that would be created.
3. Choose Add to add one template, or "Add pack" to add a whole pack.

A template is skipped if you already have a room with the same name.

Rooms added from a template are yours. Edit them like any other room.

Template updates

Templates can get new versions. Nothing updates by itself. When a newer version exists, the room appears under "Updates available". Choose Update to apply it. Rooms you changed are never overwritten; they are listed as changed and left as they are.

Rooms on a new server

A new VoiceLink server starts with only two rooms: Lobby and General. Add more from Admin, then Modules, then Room templates, or create your own.

Existing servers keep their rooms. Restarting the server never re-creates built-in rooms or rooms you deleted. See Getting Started for more on running your own server.