Skip to main content

Peer-to-peer video chat using WebRTC

Project description

Build Status docs PyPI Docker Hub License

Camus is a group video chat app that uses WebRTC for direct peer-to-peer communication. Users can create and join rooms, stream audio and video with a microphone and webcam, share their screen, and send text messages. You can try a demo at https://camus.chat, or run your own server using Snap, pip, Docker, or Heroku.

Features

  • Create public or private rooms, optionally with a password and guest limit

  • Stream audio & video

  • Share your desktop

  • Send text messages

  • Control video feeds – set your camera resolution, toggle fullscreen or picture-in-picture, disable incoming video

  • Configure custom STUN and TURN servers

  • Responsive user interface that works on large or small screens

https://raw.githubusercontent.com/mrgnr/camus/master/screenshots/0.2.0.png

Installation

Snap

Make sure you have snapd installed. Install Camus:

$ sudo snap install camus

Once installed, Camus runs automatically as a Snap service. See the Snap service management documentation for details on starting and stopping services.

Go to localhost:5000 in your browser. For local testing, you can visit the same room in multiple tabs and each tab will act as a separate client.

Pip

Camus requires Python 3.7 or higher since it makes use of Quart and async syntax. As usual, it’s best to use a virtual environment.

Install Camus:

$ pip install camus-chat

Run Camus:

$ camus

Go to localhost:5000 in your browser. For local testing, you can visit the same room in multiple tabs and each tab will act as a separate client.

Docker

You can find a pre-built Docker image on Docker Hub. Use the following command to pull the image and run a container:

$ docker run -d -p 5000:5000 mrgnr/camus

Go to localhost:5000 in your browser. For local testing, you can visit the same room in multiple tabs and each tab will act as a separate client.

Heroku

Deploy to Heroku

Simply click the button above or see the deployment documentation for detailed instructions.

Documentation

See the official documentation at https://docs.camus.chat for more information about configuring and running Camus.

Contributing

If you want to make a contribution, please read the Contributing guidelines first.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

camus-chat-0.3.0.tar.gz (427.0 kB view hashes)

Uploaded Source

Built Distribution

camus_chat-0.3.0-py3-none-any.whl (426.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page