📺 Agora Live Streaming App

⭐ If you find this project helpful, please give it a star! ⭐

A Flutter-based live streaming application using Agora SDK with full host control over viewers and co-hosts. Perfect for creating Instagram-style live streams where the host can invite co-hosts and control who watches.

• Features
• Demo
• Prerequisites
• Setup Instructions
• How to Use
• Project Structure
• Access Code System
• Permissions
• Troubleshooting
• Dependencies

The GIF above shows the complete flow:

1. Host starts a stream
2. Host shares viewer/co-host codes
3. Viewers and co-hosts join using the codes
4. Split-screen view when co-host joins

Before running this app, make sure you have:

• ✅ Flutter SDK (version 3.10.4 or higher)
• ✅ Dart SDK (comes with Flutter)
• ✅ Android Studio or Xcode (for mobile development)
• ✅ Agora Account (free tier available)

git clone <your-repo-url>
cd Agora-Live-Streaming-App

IMPORTANT: This app requires an Agora App ID to work. Without it, the live streaming will not function.

1. Go to Agora Console
2. Sign up for a free account (or log in)
3. Click "Create a Project"
4. Enter a project name (e.g., "LiveStreamApp")
5. Select "APP ID" as the authentication mechanism (NOT Token)
6. Click "Submit"
7. Copy your App ID from the project dashboard

1. Navigate to the frontend folder:

   cd frontend

2. Create or edit the .env file:

   # Create .env file if it doesn't exist
   touch .env

3. Add your Agora App ID to the .env file:

   APP_ID=your_agora_app_id_here

   Example:

   APP_ID=48bd29358ed64d50a2496ca432adf444

⚠️ Security Note: Never commit your actual App ID to public repositories. The .env file should be in .gitignore.

cd frontend
flutter pub get

# For Android
flutter run -d android

# For iOS
flutter run -d ios

# For macOS
flutter run -d macos

# For any available device
flutter run

1. Open the app
2. Enter a Channel Name (e.g., "mystream", "gaming", "cooking")
3. Tap "Start as Host"
4. Grant camera and microphone permissions when prompted
5. You're now live! 🔴
6. Tap the Share icon (top right) to get access codes
7. Share the codes with your audience:
   • Viewer Code → For people who want to watch
   • Co-Host Code → For people who want to broadcast with you

1. Get the Viewer Access Code from the host
2. Open the app
3. Paste the code in the "Access Code" field
4. Tap "Join Stream"
5. Enjoy watching! 📺

1. Get the Co-Host Access Code from the host
2. Open the app
3. Paste the code in the "Access Code" field
4. Tap "Join Stream"
5. Grant camera and microphone permissions
6. You're now broadcasting alongside the host! 🎥

Agora-Live-Streaming-App/
├── README.md                    # This file
├── agora_live_streaming.gif     # Demo GIF
├── agora_live_streaming.mp4     # Demo video
├── agora_live_streaming.mov     # Demo video (original)
│
└── frontend/                    # Flutter app
    ├── .env                     # ⚠️ Contains your Agora App ID
    ├── pubspec.yaml             # Dependencies
    ├── lib/
    │   ├── main.dart            # Main app code
    │   └── live_stream_screen.dart
    ├── android/                 # Android-specific files
    ├── ios/                     # iOS-specific files
    ├── macos/                   # macOS-specific files
    ├── linux/                   # Linux-specific files
    └── test/                    # Test files

The app uses a simple but effective code-based access control:

┌─────────────────────────────────────────────────────────────────┐
│                           HOST                                   │
│                                                                  │
│  1. Creates channel "mystream"                                   │
│  2. Generates unique codes:                                      │
│     • Viewer Code:  mystream_viewer_123456                       │
│     • Co-Host Code: mystream_cohost_789012                       │
│  3. Shares codes selectively                                     │
└─────────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┴───────────────┐
              │                               │
              ▼                               ▼
┌─────────────────────────┐     ┌─────────────────────────┐
│        VIEWER           │     │        CO-HOST          │
│                         │     │                         │
│ • Enters viewer code    │     │ • Enters co-host code   │
│ • Can only watch        │     │ • Can broadcast video   │
│ • No camera/mic needed  │     │ • Appears in split view │
└─────────────────────────┘     └─────────────────────────┘

• ✅ Simple - No complex signaling infrastructure needed
• ✅ Reliable - Works without additional messaging SDK
• ✅ Host Control - Host decides who gets which code
• ✅ Easy to Share - Codes can be shared via any messaging app

The app automatically:

1. Requests permissions when you try to start/join as host or co-host
2. Shows a dialog if permissions are denied
3. Offers to open device settings if permissions are permanently denied

⚠️ Note: iOS Simulator does NOT support camera or microphone hardware. Test on a real iOS device or use Android emulator/macOS for full functionality.

Android:

1. Go to Settings → Apps → Live Stream → Permissions
2. Enable Camera and Microphone

iOS:

1. Go to Settings → Privacy → Camera/Microphone
2. Enable for Live Stream app

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

If you encounter any issues:

1. Check the Troubleshooting section
2. Review Agora Documentation
3. Open an issue in this repository

Made with ❤️ using Flutter and Agora SDK