Skip to main content

Events Management

This guide walks you through the full Event management flow in the Palabra user interface. It covers how to create an Event, create and configure Channels, start and stop streaming at both Event and Channel level, share and use the Listener Page, and update Channel settings for routing, translation, audio, and advanced options.

How to create an Event​

  1. Open Events.
  2. Click Create Event.
  3. Fill in general event information (shown to attendees on the Listener Page):
    • Name - custom event title
    • Description - custom event description
    • Date - event start date
    • Time - event start time
    • Timezone - timezone for the selected date and time
    • Duration - event duration in hours
  4. Click Create Event to submit the form.

Create Event Create Event

After creation, the Event appears in the Events list as a card, ready to open.

Create Event

How to create an Event Channel​

A Channel is a scoped set of configurations for a specific audio device. When you create a Channel, you attach a specific audio device (microphone) to the Event, define the language spoken by that microphone's owner, and specify which languages Palabra should translate the speech into.

Event Channel creation​

  1. Open your Event card (from the Events page).
  2. In the channel sidebar, click Create Channel.
  3. In New translation channel, set:
    • Channel name
    • Stream input type (Microphone)
    • Speaking (source language)
    • Translate to (one or more target languages)
  4. Click Create Channel.

create_channel create_channel_form

Notes:

  • You must choose languages before creation. But you can change them anytime later.
  • New channels open automatically after creation.

channels_list

How many Channels do you need to create​

You must create at least one Channel for each Event. Whether you need more depends on your Event setup. For practical scenarios, see Event Channel setup examples.

How to start and stop an Event​

Start/stop all Channels in an Event​

  1. Open the event page.
  2. Click Start Event in the header to start all eligible channels.
  3. Click Stop Event to stop all running channels for that event.

Start Event

When you start the Event, all created Channels start streaming. If you have more than one Channel, they all start in parallel.

Note: Start Event is disabled when there are no Channels. You must create at least one Channel.

Start/stop per Channel​

If you prefer, you can start each Channel individually. This can reduce billing if you start only the Channels needed at that moment.

  1. Open the channel.
  2. Go to the Routing tab (the default tab).
  3. Select a microphone device in the Microphone dropdown.
  4. Click Start Streaming (or Stop Streaming).

start_streaming

How to use the Listener Page​

Share the Listener Page link and QR code​

  1. Click the Share button on the Event card or in the header of the Event page.
  2. In the Invite your audience pop-up:
    • Copy/open Invite Link
    • Download the event QR code (optional)

Share Event Share Popup

Use the Listener Page​

On the Listener Page:

  1. Use the language picker in the bottom toolbar to select Original or a translation language.
  2. Use the audio switch to enable/disable translated audio playback.
  3. Read live captions in the center area.

If there is no live stream yet, the page shows a “not active/no captions yet” message and event start time.

listener_page

As soon as any Channel starts streaming original speech, the Listener Page starts showing text captions and real-time audio for the original speech and all configured target languages.

captions_en captions_fr captions_de

If multiple Channels run in parallel, captions and speech audio in the same language from all Channels are combined into one shared feed and audio output on the same Listener Page.

This means multiple Channels can be active at the same time if needed, but speakers across all Channels are intended to speak one by one (not in parallel).

Note: Channels are intended to organize speakers with different source languages and audio device setups for the same Event output. Channels are not intended for 2+ stages that process different topics in parallel. If you have 2+ stages that must run in parallel (each stage has a separate, independent speaker), create a separate Palabra Event for each stage to have a different Listener Page for each stage.

How to edit an Event​

  1. Open the Events list.
  2. Click the Settings button (gear icon) in the header.
  3. Click Edit.
  4. Update fields in Editing event dialog.
  5. Click Apply Changes.

delete_edit_event

The Event edit form looks and works the same as the Event creation form, so you can edit the title, description, and other general event information.

How to edit an Event Channel​

  1. Open the Events list.
  2. Open the Event and select the Channel from the sidebar.
  3. Edit settings in these tabs:
    • Routing (input/microphone state)
    • Translation (source/target languages)
    • Audio (voice and audio behavior)
    • Settings (channel name and description)
  4. When the bottom bar appears, click Apply Changes to save.

Notes:​

  • Cancel in the bottom bar reverts unsaved channel changes.
  • Applying changes can restart the stream (UI warns about this).
  • Advanced JSON options are available in the Settings tab.

Channel Routing tab​

Here you select the Channel's audio device (microphone), which is used as the speech source for translation in this Channel.

You can also start and stop streaming audio from the selected audio device here.

channel_tab1

Channel Translation tab​

Here you can adjust the source (Speaking) language and target (Translate to) languages, if needed.

channel_tab2

Channel Audio tab​

Here you can configure audio settings for Listener Page users:

  • Sync Translated Audio - adds delay (in seconds) to translated audio to match audio and video streams. Useful if your Event also streams video to the Listener Page (coming soon).
  • Original Base Volume while Translation - adjusts how Listener Page users hear original audio while translation is silent. Set it above zero if you want translated-stream users to also hear some original audio.
  • Original Ducked Volume while Translation - adjusts how Listener Page users hear original audio while translation is speaking. Keep it at zero or low if you want the original audio to be silent or ducked while translation speech is playing.
  • Translation Voice and Multiple Speaker Voice - adjust the voices used for translated speech.

channel_tab3

Channel Settings tab​

This tab lets you change the title and description of the selected Channel.

Show Advanced Settings opens the raw JSON advanced configuration. Do not change any JSON settings unless you are an advanced Palabra API user or have been guided by the Palabra support team.

channel_tab4

How to delete an Event​

  1. Open the Events list.
  2. Open the event.
  3. Click Settings (gear icon) -> Delete Event.
  4. Confirm with Yes, Delete.

delete_edit_event

Deleting an Event also deletes all Channels in that Event.

How to delete an Event Channel​

  1. Open the Events list.
  2. Open the Event.
  3. In the Channel list, find the Channel card.
  4. Open the Channel's 3-dot menu.
  5. Click Delete.

delete_channel