view doc/libervia-cli/bookmarks.rst @ 4382:b897d98b2c51 default tip

plugin XEP-0297: Reworked `forward` method and add bridge method: `Forward` method has been reworked and now includes a fallback. XEP-0297 ask to not use fallback, but following a discussion on xsf@, we agreed that this is a legacy thing and a fallback should nowadays be used, I'll propose a patch to the specification. A `message_forward` has been added to bridge. rel 461
author Goffi <goffi@goffi.org>
date Fri, 04 Jul 2025 12:33:42 +0200
parents f72d6b86f8dc
children
line wrap: on
line source

===========================
bookmarks: Manage bookmarks
===========================
Bookmarks are used to store a list of group chat rooms and indicate which ones are
currently joined. Libervia offers commands to list, set, and remove bookmarks.

list
====

Get and print available bookmarks.

example
-------
Retrieve all bookmarks::

  $ li bookmarks list

set
===

Add or update a bookmark.

You can use ``-n NAME, --name NAME`` to specify a name for the bookmark. This option
allows you to provide a human-readable name for the bookmark, making it easier to
identify.

``-N NICK, --nick NICK`` set the nickname to use in the room.

``-j [BOOL], --join [BOOL]`` indicates whether you want to join the room. If the value is not set or ``true``, the room will be joined; otherwise, it will be left if the user is currently in it.

example
-------
Add a bookmark to a chat room with a name and join it::

  $ li bookmarks set lunch@conference.example.net -n "Lunch Organization" -j

remove
======
Remove a bookmark.

example
-------
Remove a bookmark for a chat room::

  $ li bookmarks remove lunch@conference.example.net

legacy
======

Manage legacy bookmarks. Please check :ref:`libervia-cli_bookmarks_legacy`.