Skip to content

Privoce/vocespace-client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

656 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

VoceSpace logo

VoceSpace

Private-hosted 4K Video Conferencing at 60 FPS

Experience crystal-clear video meetings with 4K resolution, 60 FPS smooth performance, and 2M encoding for unmatched quality. Perfect for professional presentations and remote collaboration.

Demo

Give it a try at vocespace demo

Dev Setup

Steps to get a local dev setup up and running:

  1. Run pnpm install to install all dependencies.
  2. Copy .env.example in the project root and rename it to .env.local.
  3. Create the configuration file vocespace.conf.json
  4. Run pnpm dev to start the development server and visit http://localhost:3000 to see the result.
  5. Start development ๐ŸŽ‰

vocespace.conf.json

{
  "livekit": {
    "key": "your-production-key",
    "secret": "your-production-secret",
    "url": "ws://host.docker.internal:7880",
    "turn": {
      "urls": "turn:your-turn-server:3478",
      "username": "your-turn-username",
      "credential": "your-turn-password"
    }
  },
  "codec": "vp9",
  "resolution": "1080p",
  "maxBitrate": 3000000,
  "maxFramerate": 30,
  "priority": "medium",
  "redis": {
    "enabled": true,
    "host": "host.docker.internal",
    "port": 6379,
    "password": "",
    "db": 0
  },
  "s3": {
    "enabled": false,
    "endpoint": "your-s3-endpoint",
    "bucket": "your-bucket",
    "accessKey": "your-access-key",
    "secretKey": "your-secret-key",
    "region": "your-region"
  },
  "serverUrl": "your-domain.com",
  "hostToken": "your-host-token",
  "license": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6ImhhbkBwcml2b2NlLmNvbSIsImV4cGlyZXNfYXQiOjQ4OTEzMzQ0MDAsImNyZWF0ZWRfYXQiOjE3MzU2NjA4MDAsImRvbWFpbnMiOiIqIiwibGltaXQiOiJmcmVlIiwiaWQiOiI2NGUyMjYwZS0xMzQwLTQxNjQtOWNmZC0zMGUwMjhlYTg0ZWQifQ.T0vIHUCxv9j75lb92RDDaegpPO9W9hxWEXqZVidwL0E",
  "ai": {
    "enabled": true,
    "apiKey": "your-ai-api-key",
    "apiUrl": "your-ai-api-url",
    "model": "your-ai-model",
    "maxTokens": 4000
  }
}

Features

VoceSpace offers a comprehensive video conferencing experience with advanced AI-powered features and extensive customization options.

๐ŸŽฅ Pre-Join Experience

Basic Controls

  • Microphone Preview and Test
  • Camera Preview and Device Selection
  • Live Video Preview
  • Custom Username Input and Auto-Generation (User 01-99 Format)
  • One-Click Room Joining
  • Username Focus Upon Entry
  • Optimized Loading Time with Skeleton Screen

Advanced Settings

  • Volume Adjustment and Test
  • Multi-Microphone Device Selection
  • Video Blur Intensity Control with Live Preview
  • Multi-Camera Device Selection
  • Camera Flip Support (Mobile)
  • Settings Reset Function
  • Auto-Generate Username (ULID Based)
  • First Joiner Automatically Named admin
  • High-Quality Lossless Transmission
  • End-to-End Encryption (E2EE)
  • Device Permission Detection and Bootstrapping

๐Ÿ’ฌ Room Experience

Core Features

  • High-quality audio and video communication (4K@60fps, 2M encoding)
  • Screen sharing with audio support (configurable)
  • Multiple layout options (grid, focus, speaker view)
  • Customizable pagination controls and layout
  • Real-time chat and file sharing
  • Drag-and-drop file upload (maximum 100MB)
  • File upload progress display and cancellation function
  • Message history persistence (Redis support)
  • Unread message notification (with badge)
  • Chat message timestamps, 5-minute grouping
  • Automatic message scrolling to the latest
  • Link preview and clickable links
  • Mobile-responsive layout and controls

Host Management

  • Room ownership and host
  • Participant management (mute, video control, removal)
  • Host transfer function
  • Participant volume control
  • Other people's video/screen blur control
  • Device invitation system (camera, microphone, screen switch)
  • Room security control
  • Global quality settings management
  • Host token authentication for admin functions

Interactive Features

  • Real-time cursor sharing during screen sharing
  • Hand gesture notification and room invitation between users
  • User status indicator and custom status
  • Real-time user status synchronization and updates
  • Multi-language support (Chinese/English)
  • Search and sort participants by first letter
  • Right-click menu for user management
  • Hand-raising function with broadcast notification
  • Hand-raising speaking permission control and host approval
  • Hand-raising queue and status display
  • Quick sending of reaction emoticons

๐Ÿข Space and Room Management

Multi-room Architecture

  • Main space containing an unlimited number of sub-rooms
  • Public and Private Room Types
  • Default Sub-Rooms (Meeting Room, Coffee Break)
  • Room Creation, Deletion, and Renaming
  • Real-time Display of Participant Count and Online Status
  • Room Permission Management
  • Hoverable Expandable Auto-Collapse Sidebar
  • Room Persistence Settings (Data Retention)
  • Public Rooms Default Expand Display

Advanced Room Features

  • Private room approval system and join notification
  • Room owner permissions and control
  • Host's full permissions over all sub-rooms
  • Cross-room screen sharing permissions
  • Automatic room cleanup upon exit (non-persistent)
  • Specific room user status management
  • In-room user track subscription permission control
  • Sub-room user isolation and audio filtering

๐Ÿค– AI Features

AI Screenshot Analysis and Work Log

  • Automatic screenshots and AI analysis
  • Configurable screenshot frequency (1-15 minute interval)
  • Multi-data source support (screen sharing, to-do items, time statistics)
  • Real-time work log generation and summary
  • Export analysis results in Markdown format
  • Contextual analysis combined with historical data
  • Automatic scheduled updates of analysis results
  • Screen sharing permission request and guidance
  • Support for AI work log widget display
  • Customizable AI prompt word configuration
  • Multi-language AI analysis support

Virtual Characters

  • Live2D virtual character integrated facial tracking
  • Real-time facial tracking and animation
  • Multiple virtual character model selection
  • Customizable background and environment
  • Performance optimization and automatic detection
  • Seamless virtual character switching with masking effect
  • Before and after effect comparison mode
  • Virtual character model isolation for each user

Audio Enhancement

  • AI noise reduction
  • Real-time audio processing
  • Volume normalization
  • Customizable new user joining notification sound

๐ŸŽฌ Recording and Media

Room Recording

  • 4K full-room recording
  • Host-initiated recording
  • Participant recording requests and approval process
  • Real-time recording notifications
  • Automatic S3 storage integration
  • Download link, valid for 3 days
  • Supports mobile recording with permission detection
  • Recording management panel

File Management

  • Drag and drop file sharing in chat
  • Image preview and download
  • Automatic file organization by room
  • Secure file storage and retrieval
  • File size and type verification

๐ŸŽฎ Built-in Applications

Productivity Applications

  • To-do list application with task management
  • Editable to-do items and completion markers
  • To-do item export function (including time records)
  • Team Status displays the to-do progress of all members
  • Timer app with lap tracking
  • Customizable countdown timer
  • App floating window and scrollbar support
  • Collapsible app widget
  • Cross-participant app data sharing
  • Individual app sharing
  • Quick access via app icon in the upper right corner of the user view

App Management

  • App permissions controlled by the host
  • App data upload and synchronization
  • App history tracking
  • Personal app sharing controls (public/private)
  • App data persistence across sessions
  • Automatic upload configuration option
  • Per-user app data isolation

๐Ÿ”ง Advanced Settings

Audio Configuration

  • Device selection and switching
  • Volume control and testing
  • Real-time audio quality adjustment
  • Screen sharing audio switching
  • Customizable notification sounds

Video Configuration

  • Camera device management
  • GPU-accelerated blur intensity control (0-100%)
  • Screen sharing blur settings
  • Real-time video quality optimization
  • Lossless transmission mode
  • Dynamically adjust quality based on network connection

Virtual Environment

  • Virtual model selection with integrated Live2D
  • Background customization
  • Performance monitoring and automatic adjustment
  • Effect comparison mode
  • WebGL accelerated video processing

System Preferences

  • Multilingual interface (i18n)
  • Customizable user status creation and management
  • User status linked to to-do items
  • Theme and UI customization
  • Persistent storage settings in localStorage
  • Automatic saving and instant synchronization of settings
  • Dynamic global configuration support
  • Host configuration with hot reload function

๐Ÿ”’ Security and Privacy

Encryption and Security

  • Supports End-to-End Encryption (E2EE)
  • Secure WebRTC Communication
  • TURN Server Integration for Connectivity
  • Unique Participant ID Generation (ULID-based)
  • Session-Based Authentication
  • License Certificate Verification System
  • Domain and Participant Limit Control
  • Temporary and Official Certificate Support

Permissions and Access Control

  • Device Permission Management
  • Detailed Permission Descriptions and Guidelines
  • Fine-grained Access Control
  • Private Room Approval Process
  • Host Permission Management
  • Hand-Raising Speaking Permission Control
  • Application Data Access Permission Management

๐Ÿ—๏ธ Technical Features

Performance and Reliability

  • Client Performance Monitoring
  • Server-Side Performance Tracking (with Heartbeat)
  • WebGL Accelerated Video Processing
  • Optimized Codec Selection (VP9/VP8/H264/AV1)
  • Automatic Reconnection Mechanism
  • Connection Quality Monitoring
  • Connection Fallback Option

Infrastructure

  • Redis-based Data Persistence
  • WebSocket Real-time Communication using Socket.IO
  • Socket Disconnection Reconnection and Automatic Recovery Mechanism
  • Support for Docker Deployment and Containerization
  • Integration with S3 for Media Storage
  • Custom Express + Next.js Server Architecture
  • Support for Horizontal Scaling
  • Server Heartbeat Detection and Health Monitoring

Data Management

  • User Session Management and Unique ID Generation
  • Room Status Synchronization and Real-time Updates
  • Chat History Persistence
  • Application Data Backup and Recovery
  • Automatic Data Cleanup and Lifecycle Management
  • Persistent Room Data Retention
  • User Offline Detection and Cleanup Mechanism

๐Ÿ“Š Analysis and Monitoring

Usage Analysis

  • Real-time Active Room Monitoring
  • Historical Records, Including Daily/Weekly/Monthly Rankings
  • Meeting Duration Sorting and Leaderboard Display
  • User Activity Analysis and Leaderboard
  • Performance Metrics Dashboard
  • Participant Engagement Tracking
  • Redis Heartbeat Detection and User Status Synchronization

Management Tools

  • Management Dashboard with Comprehensive Statistics
  • Dashboard Quality Configuration Management
  • Real-time Participant Tracking for All Rooms
  • Session Duration Monitoring
  • Resource Usage Optimization
  • Global Configuration Management and Hot Reload
  • User Management and Approval Tools
  • Host Token Authentication

Development and Deployment

  • Docker Containerization and One-Click Deployment
  • Environment-Based Configuration
  • Production/Development Mode Differentiation
  • Automated Deployment Scripts (Chinese and English Versions)
  • Performance Testing and Load Balancing
  • SEO Optimization and Meta Tags
  • Multi-Environment Configuration File Support
  • Quick Local Deployment Documentation
  • Egress Recording Service Integration

For detailed feature specifications and implementation notes, see FEATURE.md and TODO.md.

CHANGELOG

See CHANGELOG

About

the client for VoceSpace base on livekit

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •