Cap Video Recorder

🎥 A FREE Capacitor 7 plugin for video recording

A simple and powerful Capacitor plugin for video and audio recording on iOS and Android platforms.

✨ Features

• 📹 Video recording with quality control
• 🎤 Audio recording support
• 📱 iOS 14.0+ and Android API 23+ support
• 🔄 Real-time recording control (start, stop, pause, resume)
• 📷 Front/back camera selection
• 💾 Save to device gallery
• 🔐 Built-in permission handling

📦 Installation

npm install cap-video-recorder
npx cap sync

iOS Setup

Add permissions to ios/App/App/Info.plist:

<key>NSCameraUsageDescription</key>
<string>This app needs camera access to record videos</string>
<key>NSMicrophoneUsageDescription</key>
<string>This app needs microphone access to record audio</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>This app needs photo library access to save videos</string>

Android Setup

Permissions are automatically added to your manifest.

📖 Usage

Basic Video Recording

import { VideoRecorder } from 'cap-video-recorder';

// Start recording
const result = await VideoRecorder.startRecording({
  quality: 'high',
  maxDuration: 60,
  camera: 'back',
  enableAudio: true,
  saveToGallery: true
});

// Stop recording
const video = await VideoRecorder.stopRecording();
console.log('Video saved:', video.videoPath);

Audio Recording

import { VideoRecorder } from 'cap-video-recorder';

// Start audio recording
await VideoRecorder.startRecording({
  enableAudio: true,
  enableVideo: false,
  maxDuration: 120
});

// Stop recording
const audio = await VideoRecorder.stopRecording();
console.log('Audio saved:', audio.audioPath);

Check Permissions

import { VideoRecorder } from 'cap-video-recorder';

// Check permissions
const permissions = await VideoRecorder.checkPermissions();

// Request permissions if needed
if (permissions.camera !== 'granted') {
  await VideoRecorder.requestPermissions();
}

🔧 API Reference

Main Methods

| Method | Description | |--------|-------------| | startRecording(options) | Start video/audio recording | | stopRecording() | Stop current recording | | pauseRecording() | Pause recording (Android 24+) | | resumeRecording() | Resume recording (Android 24+) | | getRecordingStatus() | Get current recording status | | checkPermissions() | Check camera/microphone permissions | | requestPermissions() | Request required permissions |

Recording Options

interface StartRecordingOptions {
  quality?: 'low' | 'medium' | 'high' | 'highest';
  maxDuration?: number; // seconds
  camera?: 'front' | 'back';
  enableAudio?: boolean;
  enableVideo?: boolean;
  saveToGallery?: boolean;
  fileNamePrefix?: string;
}

📄 License

MIT License

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📞 Support

If you have any questions or issues, please create an issue on GitHub.