Awesome
<p align="center"> <img title='Jam mascot by @eejitlikeme' src="https://jam.systems/img/jam.jpg" width="300" height="300"/> </p>Jam
<a href="https://discord.gg/BfakmCuXSX"></a> <a href="https://twitter.com/jam_systems">
</a> <a href="https://github.com/jam-systems/jam">
</a> <a href="https://www.npmjs.com/package/jam-react">
</a>
π Jam is an open source alternative to Clubhouse, Twitter Spaces and similar audio spaces.
With Jam you can create audio rooms that can be used for panel discussions, jam sessions, free flowing conversations, debates, theatre plays, musicals and more. The only limit is your imagination.
try Jam for free on https://jam.systems/
get your own Jam server hosted by us with the Jam Early Access Program here
join the Jam community on π§ Discord
follow Jam on π£ Twitter
π join our weekly Jam Jam (a Jam where we jam about Jam) every Wed @ 8pm CEST (2pm EDT)
add the /jam
shortcut to your Slack workspace:
<a href="https://slack.com/oauth/v2/authorize?client_id=1827991458162.1827997742338&scope=chat:write,chat:write.public,commands&user_scope="><img alt="Add to Slack" height="40" width="139" src="https://platform.slack-edge.com/img/add_to_slack@2x.png" /></a>
add Jam to your Wordpress, Webflow or Shopify:
<a href="https://medium.com/jam/add-jam-to-wordpress-ca1932cd8ff3"><img alt="Add Jam to Wordpress" src="https://s.w.org/style/images/about/WordPress-logotype-standard.png" height="40" /></a> Β Β Β <a href="https://medium.com/jam/add-jam-to-webflow-d8a680959007"><img alt="Add Jam to Webflow" src="https://upload.wikimedia.org/wikipedia/commons/9/92/Webflow_logo.svg" height="22" /></a> Β Β Β <a href="https://medium.com/jam/add-jam-to-shopify-a77865cd7b6f"><img alt="Add Jam to Shopify" src="https://upload.wikimedia.org/wikipedia/commons/thumb/0/0e/Shopify_logo_2018.svg/430px-Shopify_logo_2018.svg.png" height="22" /></a>
Feature Comparison
An overview for how π Jam compares to similar services like Clubhouse or Twitter Spaces. We intend to keep this table up to date as the services evolve. Please let us know what you care about and how we can make it easier for you to understand whether π Jam is right for you.
π Jam | π Clubhouse | π£ Twitter Spaces | |
---|---|---|---|
π¨ Branded Rooms | β set your own logo, color | β | β |
𧩠Embed in your app or website | β iFrame, WebView, JS SDK | β | β |
π― Animated Reactions | β (β€οΈ π― π π π³ π€) | β | β (π― β β βοΈ π) |
π Description w/ Links | β w/ Markdown support | β | βοΈ show tweets |
π΅ Earn Money | β dedicated support for<br/>PayPal.me, Bitcoin:, Gumroad | β no built in support<br/><br/>currently not allowed<br/>unless specifically authorized<br/> see Terms of Service<br/>(Conditions of Use #9) | β no built in support |
π± Platform support | β Web, iOS, Android,<br/>macOS, Windows, Linux, β¦ | βοΈ iOS App Store & invite | βοΈ iOS App Store & invite |
π Data Sovereignty | βοΈ EU πͺπΊ (Frankfurt, Germany π©πͺ)<br/><br/> β open source, host wherever you want | βοΈ USA πΊπΈ, China π¨π³ (Audio API Provider)<br/><br/>β proprietary, no self-hosting | βοΈ USA πΊπΈ (?)<br/><br/>β proprietary, no self-hosting |
π Number of Speakers in a Room | β ~ 15+ (limited by p2p bandwidth) | β ~ 100s (?) | βοΈ 10 |
π« Number of People in a Room | β unlimited (depending on server) | β up to 8000 (?) | β unlimited (?) |
π Discovery | βοΈ off-platform (social networks, messengers) | β hallway, upcoming events, off-platform | β fleet bar, off-platform |
π― Animated Reactions (π¬ see a demo)
π¨ Branded Rooms: set a picture and a color for your room
π΅ Earn Money: dedicated support for linkinging to off-platform services to charge money or sell your own products
Room Configuration via URL
You can configure a room by adding parameters as query parameters or as base64URL
encoded string in the hash component of a url.
You can take a look at examples for room configurations via URLs in our examples directory or in our Glide tutorial
key | value | note |
---|---|---|
room.name | name of the room | |
room.description | description of the room | |
room.color | CSS value (e.g. "red" #CCCCCC) | primary color of the room, used for the primary action button and some styling like background chrome color, note that you need to encode the hash sign using %23 if passed as query parameter (#CCCCCC becomes %23CCCCCC) |
room.stageOnly | true | users join directly on stage instead of in the audience |
ux.noLeave | true | removes the "leave" button |
ux.autoCreate | true | create room if it does not exist yet |
ux.autoJoin | true | users join the room automatically without having to click a button to join |
ux.autoRejoin | true | users re-join the room automatically if they have been in the room previously without having to click a button to join |
identity.name | name of the user | |
identity.avatar | image URL of the user | avatar, profile picture, user photo β¦ |
keys.seed | string seed for deriving a public/private keypair | a seed for deriving a public/private keypair. this keypair is for the current user within the room (related: creating rooms with a known set of moderators requires the public keys of the moderators) |
Known Issues and Solutions
π± iPhone: audio output sometimes switches randomly between loudspeaker and earspeaker.
Workaround: use bluetooth or cable headphones, this way audio will always go through the headphones.
π± iPhone & Android: when phone goes to sleep/lockscreen because of inactivity the microphone or sound output might stop working until you unlock the screen again
Workaround: make sure you are using Jam in the standalone browser instead of within a webview
Participants can hear me but I can not hear them
When participants join a room on π Jam they start in the audience, you can add them to the stage by tapping on them and by tapping the "invite to stage"
button
Host Your Own Server
Hosting your own Jam server is easy.
Minimum Requirements
To run your own Jam instance we recommend a minimum of 1 GB RAM and a 1GHz CPU.
e.g.: a Raspberry Pi (1+ GB RAM) or the smallest Digital Ocean Basic Droplet (1 GB RAM) or the smallest Linode shared plan (1 GB RAM) or t2.micro (1 GB RAM) on Amazon Web Services should be enough to get started.
Install
- Install docker and docker-compose (https://docs.docker.com/compose/install/)
git clone https://gitlab.com/jam-systems/jam.git
cd jam
git checkout stable
cd deployment
cp .env.example .env
nano .env
setJAM_HOST
to the domain you want Jam to be available (If you are deploying on AWS you need a domain you own pointing to your sever as letsencrypt does not issue certificates for*.compute.amazonaws.com
domains)- In your DNS settings point
${JAM_HOST}
, and*.${JAM_HOST}
to your IP address (if you don't want a wildcard you need the subdomainsstun
andturn
(e.g. stun.jam.example.com and turn.jam.example.com)) - If you are behind a NAT:
- Open ports 3478 and 3480, both TCP and UDP, and 80 and 443, TCP, on your firewall
nano turnserver.conf
setrealm
to your domain. If you are running coturn behind NAT, you may need to add the parameterexternal-ip
and give it the value of your public IP address.
docker-compose up -d
Update
NOTE: Make sure you have the newest version of docker-compose (install according to https://docs.docker.com/compose/install/).
cd jam/deployment
git checkout stable
git pull
docker-compose pull
docker-compose up -d
NOTE: If you update from a version before March 23rd to one after and you want to keep users' identities and rooms:
cd jam/deployment
docker-compose down
git checkout stable
git pull
docker-compose pull
mv ../pantryredis ../data
docker-compose up -d
Jam SDK
If you want to build your own audio room UI from scratch, or even develop a Jam bot, then Jam gives you the tools to do so as well! Take a look at jam-core, our npm package which exposes all functionalities of Jam as a JavaScript library, without prescribing any UI.
For easily integrating jam-core
into a React app, check out the companion package jam-core-react. The official Jam app itself is primarily built on jam-core-react
.
Develop
In in the ui
directory use yarn
to install dependencies and yarn start
to start the local development server.
Directory overview:
deployment
/ docker compose file for deploying and hosting of Jam
pantry
/ a lightweight server for handling authentication and coordination of Jam
ui
/ web based user interface based on the React framework
Buy Us β
BTC: 3HM1zPtLuwCGarbihNYVjFVwbFrFe9keqh
ETH: 0xe15265b2a309f0d20038e10b8df5a12fb5e916f8