AWS Chime Client v4.0A secure, enterprise-ready Amazon Chime SDK v3 client with AWS Cognito authentication and advanced video features including background blur, virtual backgrounds, screen sharing, and real-time participant roster.
Production-ready security — requires authentication via AWS Cognito before accessing meetings. Works directly in your browser and interoperates seamlessly with official Amazon Chime participants.
Built with modern web standards:
- Frontend: Amazon Chime SDK JavaScript v3.20.0 (via esm.sh CDN)
- Backend: AWS Lambda + API Gateway (AWS SDK v3)
- Hosting: GitHub Pages (frontend) + AWS (backend)
All media flows through Amazon Chime's WebRTC infrastructure — the backend only handles meeting creation.
- Professional interviews with clean backgrounds
- Remote demos and presentations
- Testing Chime SDK video pipelines
- Lightweight browser alternative to desktop Chime app
- ✅ AWS Cognito Integration: Complete hosted UI authentication with JWT tokens
- ✅ Production Security: Enterprise-ready user management and access control
- ✅ Multi-Environment: Works seamlessly in localhost, GitHub Codespaces, and production
- ✅ Token Validation: Automatic JWT token parsing and API authorization
- ✅ HD Video Conferencing: Professional-grade audio/video with adaptive quality
- ✅ Background Blur: Real-time WebAssembly-powered background blur effects
- ✅ Custom Virtual Backgrounds: Upload and use custom background images
- ✅ Screen Sharing: Full-screen sharing with dedicated presentation view
- ✅ Smart Device Management: Hot-swappable camera/microphone selection
- ✅ Transform Pipeline: Real-time video processing with minimal latency
- ✅ Live Participant Roster: Real-time join/leave tracking with status indicators
- ✅ Audio/Video Status: Visual mute indicators (🎤/🔇) for all participants
- ✅ Screen Share Detection: Presenter indicators (🖥️) in participant list
- ✅ Cross-Platform Compatible: Works with official Amazon Chime desktop/mobile apps
- ✅ Meeting Persistence: Reliable connection handling with auto-recovery
- ✅ Modern Architecture: ES2020+ modules with Amazon Chime SDK v3.20.0
- ✅ WebAssembly Performance: Optimized WASM background processing via CDN
- ✅ Production UI: Professional dark theme with glassmorphism effects
- ✅ Error Recovery: Graceful handling of network issues and device changes
- ✅ Zero Installation: Complete browser-based solution with PWA capabilities
- ✅ Infrastructure as Code: Complete AWS SAM deployment automation
┌─────────────────────────┐
│ User Browser │
│ (Frontend + Auth UI) │
└───────────┬─────────────┘
│ 1. Login Flow
▼
┌─────────────────────────┐
│ AWS Cognito │
│ (Hosted UI + JWT) │
└───────────┬─────────────┘
│ 2. JWT Token
▼
┌─────────────────────────┐
│ GitHub Pages │
│ (Chime SDK Client) │
└───────────┬─────────────┘
│ 3. API Call + JWT
▼
┌─────────────────────────┐
│ API Gateway │
│ (JWT Authorizer) │
└───────────┬─────────────┘
│ 4. Authorized Request
▼
┌─────────────────────────┐
│ Lambda Function │
│ (Meeting Creation) │
└───────────┬─────────────┘
│ 5. Meeting Info
▼
┌─────────────────────────┐
│ Amazon Chime Services │
│ (WebRTC Media) │
└─────────────────────────┘
Components:
Authentication Layer (AWS Cognito)
- User Pool with hosted UI for secure login/logout
- JWT token generation and validation
- OAuth 2.0 implicit flow for browser clients
- Automatic token refresh and session management
Frontend (GitHub Pages)
- Static web client with Amazon Chime SDK v3.20.0
- Authentication UI with login/logout controls
- JWT token handling and API authorization
- Background filters (BackgroundBlurVideoFrameProcessor, BackgroundReplacementVideoFrameProcessor)
- Screen sharing controls and real-time participant roster
- Transform device pipeline with WebAssembly processing
API Security (API Gateway)
- JWT Cognito authorizer protecting all endpoints
- CORS configuration for cross-origin requests
- Automatic token validation before Lambda execution
- Rate limiting and throttling protection
Backend (AWS Lambda)
- Secure meeting creation with authenticated requests
- AWS SDK v3 for Chime service integration
- Node.js 18.x runtime with JWT validation
- Stateless, serverless architecture
- Does not process video/audio (handled by Chime WebRTC)
.
├── LICENSE
├── README.md
├── app.js # Main Chime SDK application logic
├── backend/ # AWS Lambda backend
│ ├── createMeeting.js # Meeting creation with Cognito auth
│ └── package.json
├── background-filters/ # WebAssembly background processing
│ ├── segmentation-simd.wasm
│ ├── segmentation.wasm
│ └── worker.js
├── docs/ # Documentation
│ ├── CHANGELOG.md
│ ├── CONTRIBUTING.md
│ ├── INSTRUCTIONS.md
│ ├── ROADMAP.md
│ └── index.md
├── img/ # Assets and diagrams
│ ├── aws_architecture.png
│ └── logo_dark.png
├── index.html # Main application with Cognito integration
├── scripts/ # Deployment and utility scripts
│ ├── cleanup.sh
│ ├── deploy-cognito-fix.sh
│ └── verify-cognito.sh
├── style.css # Modern dark theme styling
└── template.yaml # CloudFormation infrastructure
- Open the app: Visit GitHub Pages deployment
- Login: Click "Login" button to authenticate via AWS Cognito
- Complete authentication: Use Cognito hosted UI to sign in
- Enter meeting details: Meeting ID, your name, and AWS region
- Join meeting: Click "Join Meeting" to connect (requires authentication)
- Enable video: Click camera button to start video
- Choose background: Select None/Blur/Image from dropdown
- Upload custom image: Click "Upload Image" for virtual backgrounds
- Share screen: Click screen share button (🖥️)
- View participants: See real-time roster with mute status
- Logout: Click "Logout" when finished
- Select devices from dropdown menus
- Click 🎤 to mute/unmute
- Click 🎥 to start/stop video
- Click ⛔ to leave meeting
# Deploy complete stack with Cognito authentication
./scripts/deploy-cognito-fix.sh
# Verify Cognito configuration
./scripts/verify-cognito.sh
# Start local development server
python3 -m http.server 8000See docs/INSTRUCTIONS.md for complete deployment guide including:
- AWS CLI and SAM CLI setup
- Cognito User Pool configuration
- Backend deployment to AWS
- Frontend configuration
- GitHub Pages hosting
- Multi-environment support
- Performance depends on device CPU/GPU capabilities
- Not designed for large-scale enterprise deployments
- Background filters require modern browser with WebAssembly support
MIT License — see LICENSE file for details.
Georges Bou Ghantous
Contributions and suggestions welcome!