react-native-video-recompression


A React Native library for intelligent video processing with native performance. Features accurate bitrate analysis, smart MOV→MP4 rewrapping, and bitrate-aware compression decisions optimized for mobile chat applications and media sharing.

🚀 Key Features

- 🧠 Smart Processing: Intelligent decision engine chooses optimal strategy (passthrough/rewrap/recompress)
- 📊 Accurate Bitrate Analysis: Real track-level bitrate detection, not file-size estimates
- 📱 iOS Camera Roll Optimization: Fast MOV→MP4 rewrapping for iPhone videos
- ⚡ Performance First: Container rewrapping vs slow transcoding when possible
- 🎯 Chat App Ready: Bitrate-aware decisions for messaging apps (2Mbps/192kbps thresholds)
- 📹 Enhanced Codec Detection: H.264, HEVC, VP8, VP9, AV1, AAC, MP3, Opus support
- 🔍 Deep Video Analysis: Comprehensive metadata extraction with format details
- 📱 Cross Platform: Consistent behavior across iOS and Android

🚀 Quick Start

$3

``bash
npm install react-native-video-recompression


or


yarn add react-native-video-recompression
`

$3

`bash
cd ios && pod install
`

$3

No additional setup required - auto-linking handles everything!

🧪 Testing

$3


`bash
npm test
`

$3

`bash
npm run build
npm run validate
`

$3

Create a new React Native app and install the library:

`bash


Create new RN app

npx react-native@0.72.7 init VideoTestApp

Install the library

cd VideoTestApp
npm install react-native-video-recompression

iOS setup

cd ios && pod install && cd ..

Test on devices

npm run ios
npm run android
`

For detailed testing instructions, see TESTING.md.

Usage

`javascript
import VideoRecompression from 'react-native-video-recompression';

// Initialize and test the module
const initializeModule = async () => {
try {
const info = await VideoRecompression.init();
console.log('Module initialized:', info);
// Output: { platform: 'ios', version: '0.9.4', capabilities: ['video_analysis', 'smart_compression', ...] }
} catch (error) {
console.error('Module initialization failed:', error);
}
};

// Analyze video file with accurate bitrate detection
const analyzeVideo = async (videoPath) => {
try {
const videoInfo = await VideoRecompression.analyzeVideo(videoPath);
console.log('Video analysis:', videoInfo);
// Output: {
// container: 'mov',
// videoCodec: 'h264',
// audioCodec: 'aac',
// width: 1920, height: 1080, duration: 30.5,
// videoBitrate: 1800000, // Actual bitrate from track metadata
// audioBitrate: 128000, // Actual bitrate from track metadata
// frameRate: 30.0, fileSize: 45000000
// }
} catch (error) {
console.error('Video analysis failed:', error);
}
};

// Smart video processing for chat apps (iPhone MOV → MP4 example)
const processVideoForChat = async (inputPath, outputPath) => {
try {
const result = await VideoRecompression.processVideo(
inputPath, // '/path/to/iPhone_video.mov'
outputPath, // '/path/to/chat_optimized.mp4'
{
// Chat optimization settings
videoBitrate: 800000, // 800kbps for messaging
audioBitrate: 128000, // 128kbps for messaging
videoCodec: 'h264', // Universal compatibility
audioCodec: 'aac', // Universal compatibility
maxWidth: 1280, // Limit resolution for chat
maxHeight: 720,
optimizeForNetwork: true
},
(progress) => {
console.log(Processing: ${Math.round(progress * 100)}%);
}
);

console.log('Processing result:', result);
// For iPhone MOV with H.264+AAC and reasonable bitrate:
// {
// outputPath: '/path/to/chat_optimized.mp4',
// action: 'rewrap', // Fast container conversion!
// processingTime: 2500, // ~2.5 seconds vs 30+ for recompression
// originalInfo: { fileSize: 45000000, videoBitrate: 1800000 },
// finalInfo: { fileSize: 45000000, videoBitrate: 1800000 } // Same quality
// }
} catch (error) {
console.error('Video processing failed:', error);
}
};
`

API

$3

Initializes the module and returns platform information.

Returns:
- Promise