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.

Files for camus-chat, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size camus_chat-0.3.1-py3-none-any.whl (409.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size camus-chat-0.3.1.tar.gz (410.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page