Skip to content

waterbustech/waterbus

Repository files navigation

Computador

codecovCodeFactorGitHub Workflow Status (with event)GitHub issueslibwebrtcCocoapods VersionPRs Welcome

Twitter FollowDiscord

Website β€’ Wiki β€’ License

🌀️ About

πŸ€™ This is an Open Source Video Conferencing 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.

✨ Why is this so awesome?

  • πŸ‘₯ Multiple Participants: Waterbus enables high-quality group video calls using WebRTC SFU.
  • πŸ’» Screen Sharing: Share your screen with the participants of your call.
  • πŸŽ₯ Video Codec Support: Supports a wide range of video codecs including AV1, H.264, H.265, VP8, and VP9.
  • 🌌 Virtual Background: Enhance your meetings with professional virtual backgrounds.
  • πŸ–ΌοΈ Picture-in-Picture: Increase productivity with picture-in-picture multitasking.
  • πŸ”’ End-to-End Encryption: Ensure secure meetings with end-to-end encryption.
  • πŸ’‹ Beauty Filter: Using GPUPixel to implement Beauty Filters

🎯 Goal

My project isn't intended to replace standard video conferencing platforms like Google Meet. Instead, it focuses on facilitating code sharing. I've noticed that features such as Virtual Background or Picture in Picture aren't widely implemented in existing solutions, and there's a lack of reference code for them. Many developers resort to third-party solutions for video calls but often miss out on these features. My goal is to provide a reference project that includes these functionalities, offering developers a starting point for integrating them into their own products.

If you have suggestions or problems, please open an issue or contribute directly πŸ€“

πŸ‘‰ The Virtual Background feature supports on Android, iOS and MacOS


Virtual Background on iOS (VisionKit for Person segment) Virtual Background on Android (Mediapipe for Image segment) Virtual Background on MacOS (VisionKit for Person segment)

⚑ Current supported features

Feature Subscribe/Publish Screen Sharing Picture in Picture Virtual Background Beauty Filters End to End Encryption
Android 🟒 🟒 🟒 🟒 🟑 🟒
iOS 🟒 🟒 🟒 🟒 🟒 🟒
MacOS 🟒 🟒 πŸ”΄ 🟒 🟒 🟒
Web 🟒 🟒 🟑 🟒 🟑 🟒

🟒 = Available

🟑 = Coming soon (Work in progress)

πŸ”΄ = Not currently available (Possibly in the future)

Note

  • AV1 supported on iOS 14 and above, Android 14 and above.
  • E2EE only supported H264, VP8 and VP9
  • Video codec Android supported: Check at Google Site
πŸ–ΌοΈ Online Meeting Diagram

Diagram Diagram

πŸš€ Getting Started

To compile Waterbus from the source code, follow these steps:

  1. Install Flutter.
  2. Clone the Waterbus repository.
  3. Run flutter pub get to download dependencies.
  4. Run flutter run to start the app.

πŸ› οΈ Building

These commands are intended for maintainers only.

Android

Set keystore password if you use jks in this repo, or create your own

export KEY_WATERBUS_PASSWORD=banhcuon
export ALIAS_WATERBUS_PASSWORD=banhcuon

Traditional APK

flutter build apk

AppBundle for Google Play

flutter build appbundle

iOS

Pod install

cd ios
bash clean-pods.sh
flutter build ipa

macOS

Pod install

cd macos
bash clean-pods.sh
flutter build macos

Web

flutter build web

πŸ”₯ Usage

  1. Sign in with Google
  2. Create a new meeting
  3. Share the meeting code & password with other participants
  4. Start the meeting and utilize the available features

πŸ›  Selfhosted Waterbus

⏲️ Benchmarking

  • 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.
  • The benchmark aims to quickly compare the performance differences between these codecs during a short online meeting session.

πŸ“± Device Specifications

  • Model: iPhone 13
  • Operating System: iOS 17.0.2

🌟 Results

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

VP8 - Total encode time: 9325 (Β΅s) in 60s call lambiengcode
VP9 - Total encode time: 12091 (Β΅s) in 60s call lambiengcode
H264 - Total encode time: 11127 (Β΅s) in 60s call lambiengcode
H265 - Total encode time: 9264 (Β΅s) in 60s call lambiengcode
AV1 - Total encode time: 13615 (Β΅s) in 60s call lambiengcode

πŸ’™ Supports

Support it by joining stargazers for this repository. ⭐

Also, follow maintainers on GitHub for our next creations!

Star History Chart Star History Chart

Stargazers repo roster for @waterbustech/waterbus Stargazers repo roster for @waterbustech/waterbus

🀝 Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue if you encounter any problems or have suggestions for improvements.

πŸ“§ Contact Information

If you have any questions or suggestions related to this application, please contact me via email: lambiengcode@gmail.com.