Skip to content

Commit 01ce37c

Browse files
authored
Merge pull request #219 from lambiengcode/docs/add-stargazers
docs(): add stargazers list in README.md
2 parents 9aa9075 + 9220704 commit 01ce37c

File tree

1 file changed

+55
-74
lines changed

1 file changed

+55
-74
lines changed

README.md

Lines changed: 55 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,70 @@
1-
[![codecov](https://codecov.io/gh/lambiengcode/waterbus/branch/main/graph/badge.svg?token=7KEMH26LHZ)](https://codecov.io/gh/lambiengcode/waterbus)[![CodeFactor](https://www.codefactor.io/repository/github/lambiengcode/waterbus/badge)](https://www.codefactor.io/repository/github/lambiengcode/waterbus)[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=lambiengcode_waterbus&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=lambiengcode_waterbus)![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/lambiengcode/waterbus/ci.yml)![GitHub issues](https://img.shields.io/github/issues/lambiengcode/waterbus)[![libwebrtc](https://img.shields.io/badge/libwebrtc-120.6099.19-yellow.svg)](https://chromium.googlesource.com/external/webrtc/+/branch-heads/6099)![Cocoapods Version](https://img.shields.io/cocoapods/v/KaiRTC)
2-
[![Twitter Follow](https://img.shields.io/twitter/follow/waterbus.tech?style=social)](https://twitter.com/lambiengcode)[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat&logo=github)](https://github.com/lambiengcode)
3-
4-
[![Banner](./screenshots/banner-dark.png)](https://docs.waterbus.tech#gh-dark-mode-only)
5-
[![Banner](./screenshots/banner.png)](https://docs.waterbus.tech#gh-light-mode-only)
6-
7-
# [Waterbus](https://docs.waterbus.tech): Online Meeting App using Flutter and WebRTC SFU (Selective Forwarding Unit)
8-
9-
<p align="justify">
10-
<img src="https://github.com/lambiengcode/waterbus/blob/main/screenshots/launcher_icon_rounded.png?raw=true" width="180px" height=auto align="right" alt="Computador"/>
11-
This is an Online Meeting App that utilizes Flutter and WebRTC technologies to provide users with a platform to conduct virtual meetings, conferences, and webinars. The app is built to provide seamless audio and video communication, as well as screen sharing, chat functionality, and file sharing.
12-
13-
The Waterbus concept has been used for physical transportation, but it can also be applied to online meeting platforms. A virtual Waterbus platform would allow users to travel along a virtual route and stop at designated locations to attend meetings. The platform could also incorporate gamification elements for increased engagement. This approach provides a unique and fun way for remote teams to collaborate while acknowledging the trend of using waterways for transportation.
1+
<p align="center">
2+
<img src="https://github.com/lambiengcode/waterbus/blob/main/screenshots/launcher_icon_rounded.png?raw=true" width="180px" height=auto alt="Computador"/>
3+
</p>
144

5+
<h1 align="center"><a href="https://docs.waterbus.tech">Waterbus</a></h1>
6+
<h3 align="center">Online Meeting App using Flutter and WebRTC SFU (Selective Forwarding Unit)</h3>
7+
<p align="center">
8+
🤙 This is an Online Meeting App that utilizes Flutter and WebRTC technologies to provide users with a platform to conduct virtual meetings, conferences, and webinars. The app is built to provide seamless audio and video communication, as well as screen sharing, chat functionality, and file sharing.
9+
</p>
10+
<div class="badges" align="center">
11+
<p><a href="https://codecov.io/gh/lambiengcode/waterbus"><img src="https://codecov.io/gh/lambiengcode/waterbus/branch/main/graph/badge.svg?token=7KEMH26LHZ" alt="codecov"></a><a href="https://www.codefactor.io/repository/github/lambiengcode/waterbus"><img src="https://www.codefactor.io/repository/github/lambiengcode/waterbus/badge" alt="CodeFactor"></a><a href="https://sonarcloud.io/summary/new_code?id=lambiengcode_waterbus"><img src="https://sonarcloud.io/api/project_badges/measure?project=lambiengcode_waterbus&amp;metric=alert_status" alt="Quality Gate Status"></a><img src="https://img.shields.io/github/actions/workflow/status/lambiengcode/waterbus/ci.yml" alt="GitHub Workflow Status (with event)"><img src="https://img.shields.io/github/issues/lambiengcode/waterbus" alt="GitHub issues"><a href="https://chromium.googlesource.com/external/webrtc/+/branch-heads/6099"><img src="https://img.shields.io/badge/libwebrtc-120.6099.19-yellow.svg" alt="libwebrtc"></a><img src="https://img.shields.io/cocoapods/v/KaiRTC" alt="Cocoapods Version">
12+
<a href="https://twitter.com/lambiengcode"><img src="https://img.shields.io/twitter/follow/waterbus.tech?style=social" alt="Twitter Follow"></a><a href="https://github.com/lambiengcode"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat&amp;logo=github" alt="PRs Welcome"></a></p>
13+
</div>
14+
15+
<p align="center">
16+
<a href="https://docs.waterbus.tech">Website</a> &bull;
17+
<a href="https://github.com/lambiengcode/waterbus/wiki">Wiki</a> &bull;
18+
<a href="https://github.com/lambiengcode/waterbus/blob/main/LICENSE">License</a>
1519
</p>
1620

17-
### 📺 Demo Video on Youtube
21+
[![Banner](./screenshots/banner-dark.png)](https://docs.waterbus.tech#gh-dark-mode-only)
22+
[![Banner](./screenshots/banner.png)](https://docs.waterbus.tech#gh-light-mode-only)
23+
<h3 align="center">👉 The Virtual Background feature supports both Android and iOS</h3>
24+
<br/>
25+
<div align="center">
26+
<p><a href="https://youtube.com/shorts/Ms4avix05uY"><img src="https://ytcards.demolab.com/?id=Ms4avix05uY&amp;title=Virtual%20Background%20on%20iOS%20%28VisionKit%20for%20Person%20segment%29&amp;lang=en&amp;timestamp=1709774408&amp;background_color=%230d1117&amp;title_color=%23ffffff&amp;stats_color=%23dedede&amp;max_title_lines=2&amp;width=250&amp;border_radius=10&amp;duration=21" alt="Virtual Background on iOS (VisionKit for Person segment)" title="Virtual Background on iOS (VisionKit for Person segment"></a>
27+
<a href="https://youtube.com/shorts/PDIDbVoHT5o"><img src="https://ytcards.demolab.com/?id=PDIDbVoHT5o&amp;title=Virtual%20Background%20on%20Android%20%28Mediapipe%20for%20Image%20segment%29&amp;lang=en&amp;timestamp=1709774408&amp;background_color=%230d1117&amp;title_color=%23ffffff&amp;stats_color=%23dedede&amp;max_title_lines=2&amp;width=250&amp;border_radius=10&amp;duration=27" alt="Virtual Background on Android (Mediapipe for Image segment)" title="Virtual Background on Android (Mediapipe for Image segment"></a></p>
28+
</div>
1829

19-
[![Virtual Background on iOS (VisionKit for Person segment)](https://ytcards.demolab.com/?id=Ms4avix05uY&title=Virtual%20Background%20on%20iOS%20%28VisionKit%20for%20Person%20segment%29&lang=en&timestamp=1709774408&background_color=%230d1117&title_color=%23ffffff&stats_color=%23dedede&max_title_lines=2&width=250&border_radius=10&duration=21 "Virtual Background on iOS (VisionKit for Person segment")](https://youtube.com/shorts/Ms4avix05uY)
20-
[![Virtual Background on Android (Mediapipe for Image segment)](https://ytcards.demolab.com/?id=PDIDbVoHT5o&title=Virtual%20Background%20on%20Android%20%28Mediapipe%20for%20Image%20segment%29&lang=en&timestamp=1709774408&background_color=%230d1117&title_color=%23ffffff&stats_color=%23dedede&max_title_lines=2&width=250&border_radius=10&duration=27 "Virtual Background on Android (Mediapipe for Image segment")](https://youtube.com/shorts/PDIDbVoHT5o)
2130

22-
## Current supported features
31+
### Current supported features
2332

2433
| Feature | Subscribe/Publish | Screen Sharing | Picture in Picture | Virtual Background | End to End Encryption | Record Media |
2534
| :-----: | :---------------: | :------------: | :----------------: | :----------------: | :-------------------: | :----------: |
2635
| iOS | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟡 |
2736
| Android | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟡 |
2837

29-
## Codec supported
38+
### 💥 Codec supported
3039
| Codec | VP8 | VP9 | H264 | H265 | AV1 |
3140
| :-----: | :---------------: | :------------: | :------------: | :----------------: | :--------------------------------: |
3241
| iOS | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
3342
| Android | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
3443

35-
### Notes:
36-
> [!NOTE]
37-
> `AV1` supported on iOS 14 and above, Android 14 and above.
38-
> `E2EE` only supported `H264`, `VP8` and `VP9`
39-
> Video codec Android supported: Check at [Google Site](https://developer.android.com/guide/topics/media/platform/supported-formats#video-codecs)
40-
41-
> [!WARNING]
42-
> `Virtual Background` is still in beta so it will not be stable. It is developed using [MediaPipe](https://developers.google.com/mediapipe) for `Android` and [VisionKit](https://developer.apple.com/documentation/vision/vngeneratepersoninstancemaskrequest) for `iOS`
43-
4444
🟢 = Available
4545

4646
🟡 = Coming soon (Work in progress)
4747

4848
🔴 = Not currently available (Possibly in the future)
4949

50-
## Online Meeting Diagram
50+
> [!NOTE]
51+
> - `AV1` supported on iOS 14 and above, Android 14 and above.
52+
> - `E2EE` only supported `H264`, `VP8` and `VP9`
53+
> - Video codec Android supported: Check at [Google Site](https://developer.android.com/guide/topics/media/platform/supported-formats#video-codecs)
54+
55+
> [!WARNING]
56+
> `Virtual Background` is still in beta so it will not be stable. It is developed using [MediaPipe](https://developers.google.com/mediapipe) for `Android` and [VisionKit](https://developer.apple.com/documentation/vision/vngeneratepersoninstancemaskrequest) for `iOS`
57+
58+
<details>
59+
<summary> 🖼️ Online Meeting Diagram</summary>
5160

5261
[![Diagram](./screenshots/waterbus-diagram-dark.png)](https://docs.waterbus.tech#gh-dark-mode-only)
5362
[![Diagram](./screenshots/waterbus-diagram.png)](https://docs.waterbus.tech#gh-light-mode-only)
5463

55-
## 📂 Repository Structure
64+
</details>
65+
66+
<details>
67+
<summary> 📂 Repository Structure</summary>
5668

5769
```sh
5870
└── waterbus/
@@ -174,6 +186,8 @@ The Waterbus concept has been used for physical transportation, but it can also
174186

175187
```
176188

189+
</details>
190+
177191
## 🚀 Getting Started
178192

179193
### 🔧 Installation
@@ -193,7 +207,7 @@ cd waterbus
193207
flutter pub get
194208
```
195209

196-
### 🤖 Running waterbus
210+
### 🤖 Run flutter app
197211

198212
```sh
199213
flutter run
@@ -206,7 +220,7 @@ flutter test
206220

207221
---
208222

209-
## Usage
223+
## 🔥 Usage
210224

211225
1. Sign up for an account
212226
2. Create a new meeting
@@ -219,24 +233,21 @@ flutter test
219233
- [WebRTC SFU Server](https://github.com/waterbustech/waterbus-sfu-meeting)
220234
- [Waterbus Docs](https://docs.waterbus.tech)
221235

222-
## Benchmarking
236+
## ⏲️ Benchmarking
223237

224238
- This part is benchmarking video codecs within a 60-second duration of an online meeting on an iPhone 13 running iOS 17.0.2. The codecs included in the benchmark are VP8, VP9, H.264, H.265, and AV1.
225239
- The benchmark aims to quickly compare the performance differences between these codecs during a short online meeting session.
226240

227-
[![Benchmark](./benchmark/h265-benchmark-plot.png)](https://docs.waterbus.tech#gh-dark-mode-only)
228-
[![Benchmark](./benchmark/h265-benchmark-plot-light.png)](https://docs.waterbus.tech#gh-light-mode-only)
229-
230-
### Device Specifications
241+
#### 📱 Device Specifications
231242

232243
- **Model:** iPhone 13
233244
- **Operating System:** iOS 17.0.2
234245

235-
### Results
246+
#### 🎯 Results
236247

237248
You can view the benchmark results in the generated plots and data files. Here's how you can interpret the results:
238249

239-
<details open>
250+
<details>
240251
<summary>VP8</summary>
241252
- Total encode time: 9325 (µs) in 60s call
242253

@@ -282,16 +293,16 @@ You can view the benchmark results in the generated plots and data files. Here's
282293
</picture>
283294
</details>
284295

296+
## Enjoying this project? 💙
285297

286-
## Roadmap
287-
288-
- Check at [Roadmap](./roadmap.md)
298+
[![Stargazers repo roster for @lambiengcode/waterbus](https://reporoster.com/stars/notext/dark/lambiengcode/waterbus)](https://github.com/lambiengcode/waterbus/stargazers/#lambiengcode/waterbus&Date#gh-dark-mode-only)
299+
[![Stargazers repo roster for @lambiengcode/waterbus](https://reporoster.com/stars/notext/lambiengcode/waterbus)](https://github.com/lambiengcode/waterbus/stargazers/#gh-light-mode-only)
289300

290-
## Enjoying this project? 💙
301+
Support it by joining [stargazers](https://github.com/lambiengcode/waterbus/stargazers) for this repository. ⭐
291302

292-
Show your support by [starring](https://github.com/lambiengcode/waterbus/stargazers) and following [maintainers](https://github.com/lambiengcode) on GitHub for more awesome content! ⭐️🚀
303+
Also, follow [maintainers](https://github.com/lambiengcode) on GitHub for our next creations!
293304

294-
## Star History
305+
### Stars History
295306

296307
[![Star History Chart](https://api.star-history.com/svg?repos=lambiengcode/waterbus&type=Date&theme=dark)](https://star-history.com/#lambiengcode/waterbus&Date#gh-dark-mode-only)
297308
[![Star History Chart](https://api.star-history.com/svg?repos=lambiengcode/waterbus&type=Date)](https://star-history.com/#lambiengcode/waterbus&Date#gh-light-mode-only)
@@ -303,33 +314,3 @@ Contributions are welcome! Please feel free to submit a pull request or open an
303314
## Contact Information
304315

305316
If you have any questions or suggestions related to this application, please contact me via email: `lambiengcode@waterbus.tech` or `lambiengcode@gmail.com`.
306-
307-
## License
308-
309-
```terminal
310-
MIT License
311-
312-
Copyright (c) 2023 lambiengcode
313-
314-
Permission is hereby granted, free of charge, to any person obtaining a copy
315-
of this software and associated documentation files (the "Software"), to deal
316-
in the Software without restriction, including without limitation the rights
317-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
318-
copies of the Software, and to permit persons to whom the Software is
319-
furnished to do so, subject to the following conditions:
320-
321-
The above copyright notice and this permission notice shall be included in all
322-
copies or substantial portions of the Software.
323-
324-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
325-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
326-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
327-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
328-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
329-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
330-
SOFTWARE.
331-
```
332-
333-
## Keywords
334-
335-
Online Meeting, Flutter, WebRTC, Audio Communication, Video Communication, Screen Sharing, Chat Functionality, File Sharing, Firebase, Virtual Meetings, Conferences, Webinars, AV1 Codec, H264, H265, VP9, VP8, Noise Suppresion.

0 commit comments

Comments
 (0)