1# Channels
  2
  3Channels provide a way to streamline collaborating for software engineers in many ways, but particularly:
  4
  5- Pairing – when working on something together, you both have your own screen, mouse, and keyboard.
  6- Mentoring – it's easy to jump in to someone else's context, and help them get unstuck, without the friction of pushing code up.
  7- Refactoring – you can have multiple people join in on large refactoring without fear of conflict.
  8- Ambient awareness – you can see what everyone else is working on with no need for status emails or meetings.
  9
 10Each channel corresponds to an ongoing project or work-stream.
 11You can see who's in a channel as their avatars will show up in the sidebar.
 12This makes it easy to see what everyone is doing and where to find them if needed.
 13
 14Create a channel by clicking the `+` icon next to the `Channels` text in the collab panel.
 15Create a subchannel by right clicking an existing channel and selecting `New Subchannel`.
 16
 17You can mix channels for your day job, as well as side-projects in your collab panel.
 18
 19Joining a channel adds you to a shared room where you can work on projects together.
 20
 21_Join [our channel tree](https://zed.dev/channel/zed-283) to get an idea of how you can organize yours._
 22
 23## Inviting People
 24
 25By default, channels you create can only be accessed by you.
 26You can invite collaborators by right clicking and selecting `Manage members`.
 27
 28When you have subchannels nested under others, permissions are inherited.
 29For instance, adding people to the top-level channel in your channel tree will automatically give them access to its subchannels.
 30
 31Once you have added someone, they can either join your channel by clicking on it in their Zed sidebar, or you can share the link to the channel so that they can join directly.
 32
 33## Voice Chat
 34
 35You can mute/unmute your microphone via the microphone icon in the upper right-hand side of the window.
 36
 37> Note: When joining a channel, Zed will automatically share your microphone with other users in the call, if your OS allows it.
 38> If you'd prefer your microphone to be off when joining a channel, you can do so via the [`mute_on_join`](../configuring-zed.md#calls) setting.
 39
 40## Sharing Projects
 41
 42After joining a channel, you can share a project over the channel via the `Share` button in the upper right-hand side of the window.
 43This will allow channel members to edit the code hosted on your machine as though they had it checked out locally.
 44
 45When you are editing someone else's project, you still have the full power of the editor at your fingertips; you can jump to definitions, use the AI assistant, and see any diagnostic errors.
 46This is extremely powerful for pairing, as one of you can be implementing the current method while the other is reading and researching the correct solution to the next problem.
 47And, because you have your own config running, it feels like you're using your own machine.
 48
 49We aim to eliminate the distinction between local and remote projects as much as possible.
 50Collaborators can open, edit, and save files, perform searches, interact with the language server, etc.
 51Guests have a read-only view of the project, including access to language server info.
 52
 53### Unsharing a Project
 54
 55You can remove a project from a channel by clicking on the `Unshare` button in the title bar.
 56
 57Collaborators that are currently in that project will be disconnected from the project and will not be able to rejoin it unless you share it again.
 58
 59## Channel Notes
 60
 61Each channel has a Markdown notes file associated with it to keep track of current status, new ideas, or to collaborate on building out the design for the feature that you're working on before diving into code.
 62
 63This is similar to a Google Doc, except powered by Zed's collaborative software and persisted to our servers.
 64
 65Open the channel notes by clicking on the document icon to the right of the channel name in the collaboration panel.
 66
 67> Note: You can view a channel's notes without joining the channel, if you'd just like to read up on what has been written.
 68
 69## Following Collaborators
 70
 71To follow a collaborator, click on their avatar in the top left of the title bar.
 72You can also cycle through collaborators using {#kb workspace::FollowNextCollaborator} or `workspace: follow next collaborator` in the command palette.
 73
 74When you join a project, you'll immediately start following the collaborator that invited you.
 75
 76When you are in a pane that is following a collaborator, you will:
 77
 78- follow their cursor and scroll position
 79- follow them to other files in the same project
 80- instantly swap to viewing their screenshare in that pane, if they are sharing their screen and leave the project
 81
 82To stop following, simply move your mouse or make an edit via your keyboard.
 83
 84### How Following Works
 85
 86Following is confined to a particular pane.
 87When a pane is following a collaborator, it is outlined in their cursor color.
 88
 89Avatars of collaborators in the same project as you are in color, and have a cursor color.
 90Collaborators in other projects are shown in gray.
 91
 92This pane-specific behavior allows you to follow someone in one pane while navigating independently in another and can be an effective layout for some collaboration styles.
 93
 94### Following a Terminal
 95
 96Following is not currently supported in the terminal in the way it is supported in the editor.
 97As a workaround, collaborators can share their screen and you can follow that instead.
 98
 99## Screen Sharing
100
101Share your screen with collaborators in the current channel by clicking on the `Share screen` (monitor icon) button in the top right of the title bar.
102If you have multiple displays, you can choose which one to share via the chevron to the right of the monitor icon.
103
104After you've shared your screen, others can click on the `Screen` entry under your name in the collaboration panel to open a tab that always keeps it visible.
105If they are following you, Zed will automatically switch between following your cursor in their Zed instance and your screen share, depending on whether you are focused on Zed or another application, like a web browser.
106
107> Note: Collaborators can see your entire screen when you are screen sharing, so be careful not to share anything you don't want to share.
108> Remember to stop screen sharing when you are finished.
109
110## Livestreaming & Guests
111
112A Channel can also be made Public.
113This allows anyone to join the channel by clicking on the link.
114
115Guest users in channels can hear and see everything that is happening, and have read only access to projects and channel notes.
116
117If you'd like to invite a guest to participate in a channel for the duration of a call you can do so by right clicking on them in the Collaboration Panel.
118"Allowing Write Access" will allow them to edit any projects shared into the call, and to use their microphone and share their screen if they wish.
119
120## Leaving a Call
121
122You can leave a channel by clicking on the `Leave call` button in the upper right-hand side of the window.