Basics of Nextcloud Talk — Nextcloud latest User Manual latest documentation

# Basics of Nextcloud Talk

Nextcloud Talk lets you chat and have video calls on your own server.

## Getting started

Chats and calls take place in conversations. You can create any number of conversations. There are different types of conversations:

### 1. Private (one-to-one) conversations

This is where you have a private chat or call with another Talk user.

In content sidebar, you can find additional information about the person you are chatting with, such as their email address, phone number, or other details they have shared in their profile.

Nobody except you and the other person can see this conversation or join a call in it. You can extend an ongoing call to a new group conversation by adding more people. Call will be continued there without interruption.

If a user becomes unavailable and set an out-of-office status in `Personal settings > Availability`, you will find additional information in this conversation, such as provided description, absence date, or their replacement person.

### 2. Group conversations

A group conversation can have any number of people in it. You can add internal users, email guests, groups or teams to a group conversation upon creation, or when it already exists, via the `Participants` tab.

A group conversation can be shared with a public link, so guests can join a chat and a call. It can also be opened to registered users (or users from ‘Guests’ app), so they can discover and join this conversation.

### 3. Note to self

This is a special conversation with yourself. Messages here do not have a limit for editing or deletion. You can use it to:

- Take notes: write down ideas, reminders, or important information you want to keep handy.

- Create to-do lists: use Markdown syntax to create checklists for tasks you need to complete.

- Forward messages from other chat: use the message menu to forward important messages from other conversations to your Note to self.

### 4. Disposable conversations

These conversations cover some special cases and exist for a limited period of time. Retention period can be configured by an instance administration:

- Instant meetings: these conversations can be created for quick, ad-hoc meetings. They can be started instantly from the Talk Dashboard.

- Event conversations: these are created when set as an event location by Calendar app.

- Phone conversations: these are dedicated for SIP dial-in & dial-out phone calls (requires a SIP gateway).

- Video verification: these are created, when someone tries to access a public link, protected by password with video verification (deleted instantly after call ends).

## Talk Dashboard

The Talk Dashboard is your central hub for managing and accessing your conversations. It provides an overview of your:

- Unread mentions and messages in private chats;

- Message reminders, scheduled to be tackled on later;

- Scheduled meetings, with event details and shortcut buttons to join them;

- Shortcut actions to create new conversations, join open ones, or quickly check your media devices.

## Creating a chat

You can create a private (one-to-one) chat by searching for the name of a user, a group or a team and clicking it. For a single user, a conversation is immediately created and you can start your chat. For a group or circle you get to pick a name and settings before you create the conversation and add the participants.

If you want to create a custom group conversation, click the button next to the search field and filters button and then on `Create a new conversation`.

You can then pick a name for the conversation, put a description, and set up an avatar for it (with uploaded photo or emoji), and select if the conversation should be open to external users and if other users on the server can see and join the conversation.

In the second step, you get to add participants and finalize the creation of the conversation.

After confirmation you will be redirected to the new conversation and can start communicating right away.

## View all open conversations

You can view all the conversations that you can join by clicking the button next to the search field and filters button and then on `Join open conversations.`

## Filter your conversations

You can filter your conversations using the filter button next to the search field. There are several options for filtering: 1. Unread mentions: view unread private conversations, or group conversations, where you have been mentioned. 2. Unread messages: view unread messages in all conversations you are a part of. 2. Event conversations: view all conversations, created for upcoming or past events.

You can then clear the filter from the filters menu.

## Archive conversations

You can archive conversations that you no longer need to see in your main conversation list. When a conversation is archived, it will be moved to the `Archived conversations` section. An archived conversation will not appear in your main conversation list, but it will still align with notification level set in its settings.

The list is accessible from the button at the bottom of the navigation bar.

## Sharing files in a chat

You can share files in a chat in 3 ways.

First, you can simply drag’n’drop them on the chat.

Second, you can select a file from your Nextcloud Files or a file manager by choosing the little paperclip and selecting where you’d like to pick the file from.

You can add more files until you are done and decide to share the files. You can also add a text caption to your shared files, providing a brief description or context.

All users will be able to click the files to view, edit or download them, irrespective of them having a user account. Users with an account will have the file automatically shared with them while external guest users will get them shared as a public link.

## Inserting emoji

You can add emoji using the picker on the left of the text input field.

## Smart Picker

Smart picker shortcut makes it easier to insert links, files, or other content into your conversations. Just choose the type of content you want to insert (files, Talk conversations, Deck cards, GIFs, etc.) You can also type / in the chat input to open the selector.

## Editing messages

You can edit messages and captions to file shares up to 6 hours after sending.

## Using Markdown

You can enhance your messages with a markdown syntax support. See list for usage:

Headings and dividers

    # Heading 1
    ## Heading 2
    ### Heading 3
    #### Heading 4
    ##### Heading 5
    ###### Heading 6

    Heading
    ===
    Normal text
    ***
    Normal text

Inline decorations

    **bold text** __bold text__
    *italicized text* _italicized text_
    `inline code` ``inline code``
    ```
    .code-block {
      display: pre;
    }
    ```

Lists

    1. Ordered list
    2. Ordered list

    * Unordered list
    - Unordered list
    + Unordered list

Quotes

    > blockquote
    second line of blockquote

Task lists

    - [ ] task to be done
    - [x] completed task

Tables

    Column A | Column B
    -- | --
    Data A | Data B

## Polls in chat

You can create a poll in groups chats from the new message additional actions.

A poll has two settings:

- Anonymous polls: Participants cannot see who voted for which option.

- Allow multiple choices: Participants can select more than one option.

You can also import polls for auto-fill and export polls as JSON files to save it locally.

Closing poll is possible from the poll dialog.

As a moderator, you can create the poll directly or you can save it as a draft to edit it later.

You can find poll drafts in `Shared items` tab or next to the poll title input field.

## Setting reminder on messages

You can set reminders on specific messages. If there’s an important message you want to be notified about later, simply hover over it and click on the reminder icon.

In the submenu, you can select an appropriate time to receive a notification later.

## Replying to messages and more

You can reply to a message using the arrow that appears when you hover a message.

In the `...` menu you can also choose to reply privately. This will open a one-to-one chat.

Here you can also create a direct link to the message or mark it unread so you will scroll back there next time you enter the chat. When it is a file, you can view the file in Files.

## Silent messages

If you don’t want to disturb anyone in the middle of the night, there is a silent mode for chatting. While it is enabled, other participants will not receive notifications from your messages.

## Managing a conversation

You are always moderator in your new conversation. In the participant list you can promote other participants to moderators using the `...` menu to the right of their user name, assign them custom permissions or remove them from the conversation.

Changing permissions of a user that joined a public conversation will also permanently add them to the conversation.

Moderators can configure the conversation. Select `Conversation settings` from the `...` menu of the conversation on the top to access the settings.

Here you can configure the description, guest access, if the conversation is visible to others on the server and more.

## Ban participants

To help keep discussions safe and under control, moderators can ban participants from conversations. It could be internal users or guests (in this case their IP-addresse will additionally be banned).

In the participants list, select the user or guest you, and click `Remove participant`.

There, toggle checkbox `Also ban from this conversation` and provide a reason for the ban. The banned user will be removed and prevented from rejoining.

You can later find the list of banned users in the `Moderation` section of conversation settings. Here, you can see the reason for the ban and revert it if needed.

## Messages expiration

A moderator can configure message expiration under the `Conversation settings` within the `Moderation` section. Once a message reaches its expiration time, it is automatically removed from the conversation. The available expiration durations are 1 hour, 8 hours, 1 day, 1 week, 4 weeks, or never (which is the default setting).

## Starting a call

When you’re in a conversation, you can start a call any time with the `Start call` button. Other participants will get notified and can join the call.

If somebody else has started a call already, the button will change in a green `Join call` button.

During a call, you can mute your microphone and disable your video with the buttons on the right side of the top bar, or using the shortcuts `M` to mute audio and `V` to disable video. You can also use the space bar to toggle mute. When you are muted, pressing space will unmute you so you can speak until you let go of the space bar. If you are unmuted, pressing space will mute you until you let go.

You can hide your video (useful during a screen share) with the little arrow just above the video stream. Bring it back with the little arrow again.

You can access your settings and choose a different webcam, microphone and other settings in the `...` menu in the top bar.

From media settings dialog, you can also change the background of your video.

You can change other settings in the `Talk settings` dialog.

## Starting a screen share

You can click the monitor icon on your video stream to share your screen. Depending on your browser, you will get the option to share a monitor, an application window or a single browser tab. If video from your camera is also available, other participants will see it in a small presenter view next to the screen share.

You can zoom in and out of the shared screen with mouse wheel, double click or touchpad gestures.

## Changing view in a call

You can switch the view in a call with the little four-block icon in the top-right between promoted-view and grid view. The grid view will show everyone equally big and if the people do not fit on the screen, buttons will appear on the left and right that let you navigate.

The promoted view shows the speaker large and others in a row below. If the people do not fit on the screen, buttons will appear on the left and right that let you navigate.

## Download call participants list

You can download the list of participants in a call from the `...` menu in the top bar. This will download a CSV file with the names and email addresses of all participants in the call.

The table in the CSV file contains the following columns:

- Name: The name of the participant.

- Email: The email address of the participant.

- Type: Indicates whether the participant is a registered user or a guest.

- Identifier: Unique identifier for the participant.

## Compact view of conversations list

Compact view allows to hide last message preview in the conversation list, providing a more focused interface. You can enable it from the `Talk settings` dialog in `Appearance` section.

## Messages search in a conversation

In addition to global unified search, you can search for messages within a specific conversation. In the content sidebar of a conversation, click the search icon to open the search tab.

You can narrow down your search by using filters such as date range, and sender.

🌐 English ☁️ latest

🌐 Languages

☁️ Versions
  latest
  stable
  30
  29
  28

Downloads

On Read the Docs
  Project Home
  Builds