2017-01-25 00:37:21 +01:00
|
|
|
# Keyboard shortcuts
|
2017-01-05 23:35:54 +01:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
Everything in Zulip can be done with the mouse, but mastering a few keyboard
|
|
|
|
shortcuts will change your experience of the app. Start with the basics
|
|
|
|
below, and add more to your repertoire as needed.
|
2017-05-12 03:46:24 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* [The basics](#the-basics)
|
2016-12-09 18:20:59 +01:00
|
|
|
* [Navigation](#navigation)
|
|
|
|
* [Narrowing](#narrowing)
|
2017-07-28 06:47:50 +02:00
|
|
|
* [Composing messages](#composing-messages)
|
2017-05-13 03:24:17 +02:00
|
|
|
* [Message actions](#message-actions)
|
|
|
|
* [Drafts](#drafts)
|
2017-07-28 06:47:50 +02:00
|
|
|
* [Menus](#menus)
|
|
|
|
* [Streams settings](#streams-settings-page)
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
## The basics
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Reply to message**: `r` or `Enter` — Reply to the selected
|
|
|
|
message (outlined in blue).
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **New stream message**: `c` — Start a new topic in the current stream.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2018-02-08 15:17:26 +01:00
|
|
|
* **New private message**: `x`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-07-29 14:30:39 +02:00
|
|
|
* **Cancel compose and save draft**: `Esc` or `Ctrl` + `[` — Close the compose box and save
|
2017-07-28 06:47:50 +02:00
|
|
|
the unsent message as a draft.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **View drafts**: `d` — Use the arrow keys and `Enter` to restore a draft.
|
|
|
|
Press `d` again to close.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Next message**: `↓` or `j`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-12-23 06:11:25 +01:00
|
|
|
* **Last message**: `End` or `G` — Also marks all messages in
|
2017-07-28 06:47:50 +02:00
|
|
|
the current view as read.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Next unread topic**: `n`
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2018-02-16 15:56:25 +01:00
|
|
|
* **Next unread private message**: `p`
|
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Search messages**: `/`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Toggle keyboard shortcuts view**: `?`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:05:53 +02:00
|
|
|
* **Go to default view**: `Ctrl` + `[` (or `Esc`,
|
2021-10-25 19:17:19 +02:00
|
|
|
[if enabled][disable-escape])
|
|
|
|
until you are in the [default view](/help/configure-default-view).
|
2021-03-10 13:56:10 +01:00
|
|
|
|
2021-10-25 19:17:19 +02:00
|
|
|
[disable-escape]: /help/configure-default-view#set-whether-esc-navigates-to-the-default-view
|
2017-07-28 06:47:50 +02:00
|
|
|
## Navigation
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:05:53 +02:00
|
|
|
* **Search messages**: `/` or `Ctrl` + `k`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2021-04-15 21:01:42 +02:00
|
|
|
* **Filter streams**: `q`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Search people**: `w`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-12-23 06:11:25 +01:00
|
|
|
* **Last message**: `End` or `G` — Also marks all messages in
|
2017-07-28 06:47:50 +02:00
|
|
|
the current view as read.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-12-23 06:11:25 +01:00
|
|
|
* **First message**: `Home`
|
2017-07-28 06:47:50 +02:00
|
|
|
|
|
|
|
* **Previous message**: `↑` or `k`
|
|
|
|
|
|
|
|
* **Next message**: `↓` or `j`
|
|
|
|
|
2017-12-23 06:11:25 +01:00
|
|
|
* **Scroll up**: `PgUp` or `K`
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2017-12-23 06:11:25 +01:00
|
|
|
* **Scroll down**: `PgDn`, `J`, or `Spacebar`
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2022-07-13 12:28:12 +02:00
|
|
|
* **Go back through viewing history**: `Alt` + `←`
|
|
|
|
|
|
|
|
* **Go forward through viewing history**: `Alt` + `→`
|
|
|
|
|
2016-12-09 18:20:59 +01:00
|
|
|
## Narrowing
|
2017-01-05 23:35:54 +01:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Narrow to next unread topic**: `n`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2018-02-16 15:56:25 +01:00
|
|
|
* **Narrow to next unread private message**: `p`
|
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Narrow to stream**: `s`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2019-05-15 04:39:22 +02:00
|
|
|
* **Narrow to topic or PM conversation**: `S`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Narrow to all private messages**: `P`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Cycle between stream narrows**: `A` (previous) and `D` (next)
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2020-09-20 10:14:24 +02:00
|
|
|
* **Narrow to all messages**: `a` — Shows all unmuted messages.
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2018-11-30 00:20:10 +01:00
|
|
|
* **Narrow to current compose box recipient**: `Ctrl` + `.`
|
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
## Composing messages
|
2017-01-05 23:35:54 +01:00
|
|
|
|
2017-12-23 06:11:25 +01:00
|
|
|
* **Reply to message**: `r` or `Enter` — Reply to the selected
|
2017-07-28 06:47:50 +02:00
|
|
|
message (outlined in blue). Same behavior as clicking on the message.
|
2017-05-24 21:32:07 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Reply to message, mentioning author**: `@`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Reply only to author**: `R`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2018-01-31 04:23:02 +01:00
|
|
|
* **Quote and reply to message**: `>`
|
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **New stream message**: `c` — For starting a new topic in a stream.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2018-02-08 15:17:26 +01:00
|
|
|
* **New private message**: `x`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### In the compose box
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Send message**: `Enter`, `Tab` then `Enter`, and/or `Ctrl` + `Enter`,
|
|
|
|
depending on your settings. See
|
2020-06-08 23:04:39 +02:00
|
|
|
[enable enter to send](https://zulip.com/help/enable-enter-to-send).
|
2017-06-16 06:55:07 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Insert new line**: `Enter`, or `Shift` + `Enter`, depending on your
|
|
|
|
settings. See
|
2020-06-08 23:04:39 +02:00
|
|
|
[enable enter to send](https://zulip.com/help/enable-enter-to-send).
|
2017-05-13 03:24:17 +02:00
|
|
|
|
2022-06-02 01:05:53 +02:00
|
|
|
* **Insert italic text**: `*italic*` or `Ctrl` + `I`
|
|
|
|
* **Insert bold text**: `**bold**` or `Ctrl` + `B`
|
|
|
|
* **Insert link**: `[Zulip website](https://zulip.org)` or `Ctrl` + `Shift` + `L`
|
2019-06-10 09:21:04 +02:00
|
|
|
|
2022-07-29 14:30:39 +02:00
|
|
|
* **Cancel compose and save draft**: `Esc` or `Ctrl` + `[` — Close the compose box and save
|
2017-07-28 06:47:50 +02:00
|
|
|
the unsent message as a draft.
|
|
|
|
|
|
|
|
## Message actions
|
|
|
|
|
2019-05-30 18:41:40 +02:00
|
|
|
* **Edit last message**: `←` — Open the last editable message in the current
|
2017-07-28 06:47:50 +02:00
|
|
|
view (if any).
|
|
|
|
|
|
|
|
### For a selected message (outlined in blue)
|
|
|
|
|
|
|
|
* **Show sender's profile**: `u`
|
2017-05-13 03:24:17 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **View image**: `v`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2019-04-06 15:57:48 +02:00
|
|
|
* **Edit message**: `e`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:05:53 +02:00
|
|
|
* **Star message**: `Ctrl` + `s`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **React with <img alt=":thumbs_up:" class="emoji"
|
|
|
|
src="/static/generated/emoji/images/emoji/unicode/1f44d.png"
|
|
|
|
title="thumbs up"/>**: `+`
|
|
|
|
|
|
|
|
* **Collapse/show message**: `-`
|
|
|
|
|
|
|
|
* **Toggle topic mute**: `M` — Muted topics don't show up in any views
|
2017-08-08 07:37:39 +02:00
|
|
|
(including All messages), and don't contribute to unread counts. Read more about
|
2017-07-28 06:47:50 +02:00
|
|
|
[muting topics](/help/mute-a-topic).
|
2017-05-13 03:24:17 +02:00
|
|
|
|
2020-08-11 01:47:54 +02:00
|
|
|
## Recent topics
|
2020-06-26 10:22:19 +02:00
|
|
|
|
2021-03-10 13:56:10 +01:00
|
|
|
* **View recent topics**: `t`
|
2020-09-23 09:43:59 +02:00
|
|
|
* **Search recent topics**: `t`
|
2021-03-10 13:56:10 +01:00
|
|
|
* **Escape from recent topics search**: `Esc` or arrow keys
|
2021-02-19 08:56:57 +01:00
|
|
|
* **Navigate recent topics**: Use arrow keys or vim keys (`j`, `k`, `l`, `h`).
|
2020-06-26 10:22:19 +02:00
|
|
|
|
|
|
|
Use `Enter` to engage with elements.
|
|
|
|
|
2017-05-13 03:24:17 +02:00
|
|
|
## Drafts
|
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Toggle drafts view**: `d`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### Within the drafts view
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Edit selected draft**: `Enter`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-12-23 06:11:25 +01:00
|
|
|
* **Delete selected draft**: `Backspace`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
Keyboard navigation (e.g. arrow keys) works as expected.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
## Menus
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Toggle shortcuts help**: `?`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Toggle gear menu**: `g`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### For a selected message (outlined in blue)
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Toggle emoji reactions menu**: `:`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Toggle message actions menu**: `i`
|
|
|
|
|
|
|
|
## Streams settings page
|
|
|
|
|
|
|
|
* **Scroll through streams**: `↑` and `↓`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
|
|
|
!!! tip ""
|
2021-09-10 00:44:29 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
Pressing `↑` from the first stream in the list moves
|
|
|
|
you to the **Filter streams** input.
|
|
|
|
|
2019-05-30 18:41:40 +02:00
|
|
|
* **Switch between tabs**: `←` and `→` — Switch between the
|
2017-07-28 06:47:50 +02:00
|
|
|
**Subscribed** and **All streams** tabs.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Create new stream**: `n`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### For a selected stream
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **View stream messages**: `V`
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **Toggle subscription**: `S`
|