1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# Nextcloud Talk
**A video & audio conferencing app for Nextcloud**
| Elevator |
|-------------------------------------------------------|
| [β¨ Why is this so awesome?](#-why-is-this-so-awesome) |
| [π Documentation](#-documentation) |
| [π§ Development Setup](#-development-setup) |
![](https://raw.githubusercontent.com/nextcloud/spreed/main/docs/call-in-action.jpg)
## β¨ Why is this so awesome?
* π¬ **Chat** Nextcloud Talk comes with a simple text chat, allowing you to share or upload files from your Nextcloud Files app or local device and mention other participants.
* π₯ **Private, group, public and password protected calls!** Invite someone, a whole group or send a public link to invite to a call.
* π» **Screen sharing!** Share your screen with the participants of your call.
* π **Integration with other Nextcloud apps** like Files, Calendar, User status, Dashboard, Flow, Maps, Smart picker, Contacts, Deck, and many more.
* π‘ **Weβre not reinventing the wheel!** Based on the great [simpleWebRTC](https://github.com/simplewebrtc/SimpleWebRTC) library.
* π **Sync with other chat solutions** With [Matterbridge](https://github.com/42wim/matterbridge/) being integrated in Talk, you can easily sync a lot of other chat solutions to Nextcloud Talk and vice-versa.
More in the works for the [coming versions](https://github.com/nextcloud/spreed/milestones/).
If you have suggestions or problems, please [open an issue](https://github.com/nextcloud/spreed/issues) or contribute directly π€
---
## π Documentation
* **[π€ User system requirements](https://nextcloud-talk.readthedocs.io/en/latest/user-requirements/)**
* **[π User documentation](https://docs.nextcloud.com/server/latest/user_manual/en/talk/index.html)**
* **[π» Server system requirements](https://nextcloud-talk.readthedocs.io/en/latest/system-requirements/)**
* **[π Administration documentation](https://nextcloud-talk.readthedocs.io/en/latest/#administration-documentation)**
* **[π€ Bots/Webhooks documentation](https://nextcloud-talk.readthedocs.io/en/latest/bots/)**
* **[βοΈ API documentation](https://nextcloud-talk.readthedocs.io/en/latest/#talk-api)**
### π¦ Installing for Production
Nextcloud Talk is really easy to install. You just need to enable the app from the [Nextcloud App Store](https://apps.nextcloud.com/apps/spreed) and everything will work out of the box.
There are some scenarios (users behind strict firewalls / symmetric NATs) where a TURN server is needed. That's a bit more tricky to install. You can [find instructions in our documentation](https://nextcloud-talk.readthedocs.io/en/latest/TURN/) and the team behind the Nextcloud VM has developed a script that takes care of everything for you ([vm-talk.sh](https://github.com/nextcloud/vm/blob/master/apps/talk.sh)). The script is tested on the recent Ubuntu Server LTS. Please keep in mind that it's developed for the VM specifically and any issues should be reported in that repository, not here.
Here's a short [video](https://youtu.be/KdTsWIy4eN0) on how it's done.
---
## π§ Development Setup
1. Simply clone this repository into the `apps` folder of your Nextcloud development instance.
2. Run `make dev-setup` to install the dependencies.
3. Run `make build-js`.
4. Then activate it through the apps management. π
5. To build the docs locally, install mkdocs locally: `apt install mkdocs mkdocs-bootstrap`.
### ποΈ Faster frontend developing with HMR
You can enable HMR (Hot module replacement) to avoid page reloads when working on the frontend:
1. Install and enable [`hmr_enabler` app](https://github.com/nextcloud/hmr_enabler)
2. Run `npm run serve`
3. Open the normal Nextcloud server URL (not the URL given by above command)
We are also available on [our public Talk team conversation](https://cloud.nextcloud.com/call/c7fz9qpr), if you want to join the discussion.
### πͺ Useful tricks for testing video calls
#### π₯ Joining a test call with multiple users
* Send fake-stream (audio and video) in Firefox:
1. Open `about:config`
2. Search for `fake`
3. Toggle `media.navigator.streams.fake` to **true**
4. Set `media.navigator.audio.fake_frequency` to **60** for more pleasant sound experience
* Afterwards install the [Firefox Multi-Account Containers](https://addons.mozilla.org/en-US/firefox/addon/multi-account-containers/) addon
* Now you can create multiple account containers, log in with a different Nextcloud account on each of them and join the same call with multiple different users
#### πΈ Modifying available media devices
* Disable camera until reboot: `sudo modprobe -r uvcvideo`
* Re-enable camera: `sudo modprobe uvcvideo`
### π Milestones and Branches
#### Branches
In the Talk app we have one branch per Nextcloud server version. `stable*` branches of the app should always work with the same branch of the Nextcloud server.
This is only off close to releases of the server, to allow easier finishing of features, so we don't have to backport them.
#### Milestones
* `v17.0.0` - *Numeric* milestones are settled and waiting for their release or some final polishing
* `π Next Patch (27)` - The **next patch** milestone is for issues/PR that go into the next Dot-Release for the given Nextcloud version (in the example 27 - e.g. 17.0.1)
* `π Next Major (28)` - The **next major** milestone is for issues/PR that go into the next feature release for the new Major Nextcloud version (as there are Patch releases for 27, this would be 28)
* `π Backlog` - The **backlog** milestone is assigned to all remaining issues
You can always pick a task of any milestone, and we will help you to get it into the assigned milestone or also an earlier one if time permits. It's just a matter of having an overview and better visibility what we think should be worked on, but it's not exclusive.
### π Contribution Guidelines
For more information please see the [guidelines for contributing](https://github.com/nextcloud/spreed/blob/main/.github/contributing.md) to this repository.
|