Commands ======== Commands start with the ``/`` character and can take a list of any number of arguments, separated by spaces. If an argument should contain a space, you can use the ``"`` character to surround this argument. The commands described in this page are shown like this: ``/command [optional argument]`` You can get the same help as below from inside poezio with the :term:`/help` command. .. note:: Use command parameters like this: - Do not use quotes if they are unnecessary (words without special chars or spaces) - If the command takes several agrguments, you need to put quotes around arguments containing special chars such as backslashes or quotes - If the command always takes only one argument, then do not use quotes even for words containing special chars .. _global-commands: Global commands ~~~~~~~~~~~~~~~ These commands work in *any* tab. .. glossary:: :sorted: /help **Usage:** ``/help [command]`` If called without an argument, this command will list the available commands. If it has a valid command as an argument, this command will show the usage and the help for the given command. /join **Usage:** ``/join [room_name][@server][/nick] [password]`` Join the specified room. You can specify a nickname after a slash (/). If no nickname is specified, you will use the default_nick in the configuration file. You can omit the room name: you will then join the room you're looking at (useful if you were kicked). You can also provide a room_name without specifying a server, the server of the room you're currently in will be used. You can also provide a password to join the room. *Examples:* - ``/join room@server.tld`` - ``/join room@server.tld/John`` - ``/join room2`` - ``/join /me_again`` - ``/join`` - ``/join room@server.tld/my_nick password`` - ``/join / password`` /destroy_room **Usage:** ``/destroy_room [room JID]`` Try to destroy the room given as a parameter, or the current room is not parameter is given and the current tab is a chatroom. You need to be the owner of a room or a server admin to destroy it. /exit /quit Just disconnect from the server and exit poezio. /load **Usage:** ``/load [ …]`` Load or reload one or several plugins. /unload **Usage:** ``/unload [ …]`` Unload one or several plugins. /plugins List the loaded plugins. /next Go to the next room. /prev Go to the previous room. /win /w **Usage:** ``/win `` Go to the matching tab. If the argument is a number, it goes to the tab with that number. Otherwise, it goes to the next tab whose name contains the given string. /status **Usage:** ``/status [status message]`` Set your availability and (optionaly) your status message. The argument is one of "available, chat, away, afk, dnd, busy, xa" and the optional [status] argument will be your status message.' /bookmark **Usage:** ``/bookmark [roomname][/nick] [autojoin] [password]`` Bookmark the specified room. This command uses almost the same syntax as /join. Type ``/help join`` for syntax examples. Note that when typing /bookmark on its own, the room will be bookmarked with the nickname you're currently using in this room (instead of default_nick). You can specify an optional *autojoin* and *password* if you call it with the full line (/bookmark alone will put the room in autojoin without password). The bookmarks stored with this command are stored on your xmpp server. /bookmark_local **Usage:** ``/bookmark_local [roomname][/nick]`` Bookmark the specified room (you will then auto-join it on each poezio start). This commands uses almost the same syntax as /join. Type /help join for syntax examples. Note that when typing /bookmark on its own, the room will be bookmarked with the nickname you're currently using in this room (instead of default_nick). The bookmarks stored with this command will be stored locally. They have priority over the ones stored online. /remove_bookmark **Usage:** ``/remove_bookmark [room_jid]`` Remove the bookmark on *room_jid* or the one on the current tab, if any. /bookmarks **Usage:** ``/bookmarks`` Open a :ref:`bookmarks tab` in order to edit the current boookmarks. /set **Usage:** ``/set [plugin|][section]