react-native-video-recompression
Advanced tools
A React Native library for intelligent video processing with native performance. Supports video analysis, quality-preserving format conversion, and smart recompression with customizable settings.
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.
npm install react-native-video-recompression
# or
yarn add react-native-video-recompression
cd ios && pod install
No additional setup required - auto-linking handles everything!
npm test
npm run build
npm run validate
Create a new React Native app and install the library:
# 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.
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);
}
};
init(): Promise<object>Initializes the module and returns platform information.
Returns:
platform: 'ios' | 'android'version: Module versioncapabilities: Array of supported featuresanalyzeVideo(filePath: string): Promise<VideoInfo>Analyzes a video file and returns comprehensive information about its properties.
Parameters:
filePath (string): Absolute path to the video fileReturns:
container: File format (mp4, mov, avi, etc.)videoCodec: Video codec (h264, hevc, vp8, vp9, av1, etc.)audioCodec: Audio codec (aac, mp3, opus, vorbis, flac, etc.)width, height: Video dimensionsduration: Duration in secondsvideoBitrate, audioBitrate: Accurate bitrates from track metadata (not estimates)frameRate: Frames per secondfileSize: File size in bytesprocessVideo(inputPath, outputPath, settings?, onProgress?): Promise<CompressionResult>Intelligently processes video with optimal strategy selection (passthrough, rewrap, or recompress).
Parameters:
inputPath (string): Absolute path to input videooutputPath (string): Absolute path for output videosettings (optional): Compression settings objectonProgress (optional): Progress callback function (0.0 to 1.0)Returns:
outputPath: Path to processed videoaction: Strategy used ('passthrough' | 'rewrap' | 'recompress')originalInfo: Input video informationfinalInfo: Output video informationprocessingTime: Processing time in millisecondsProcessing Strategies:
Smart Decision Logic:
Perfect for messaging apps like WhatsApp, Telegram, or custom chat applications:
// iPhone camera roll video optimization
const optimizeForChat = async (cameraRollVideoPath) => {
const analysis = await VideoRecompression.analyzeVideo(cameraRollVideoPath);
// Typical iPhone video: MOV container, H.264 video, AAC audio
if (analysis.container === 'mov' &&
analysis.videoCodec === 'h264' &&
analysis.videoBitrate <= 2000000) {
// Result: Fast rewrap (2-5 seconds) instead of slow recompression (30+ seconds)
const result = await VideoRecompression.processVideo(input, output, {
videoBitrate: 800000, // 800kbps for chat
audioBitrate: 128000 // 128kbps for chat
});
console.log(result.action); // 'rewrap' - preserves quality, changes container
}
};
AVFoundation framework with AVAssetExportSession and AVAssetTrackestimatedDataRate property from tracks (not file-size estimation)AVAssetExportPresetPassthrough for fast container conversion (MOV→MP4)MediaExtractor, MediaMuxer, and MediaMetadataRetriever for comprehensive analysisMediaFormat.KEY_BIT_RATEBefore using in production, test the library with real video files:
# Create test video files (requires FFmpeg)
./scripts/create-test-videos.sh
# Run example app for interactive testing
yarn example:ios # iOS
yarn example:android # Android
# Run unit tests
yarn test
See TESTING.md for comprehensive testing guide.
See the contributing guide to learn how to contribute to the repository and the development workflow.
MIT
Made with create-react-native-library
FAQs
A React Native library for intelligent video processing with native performance. Supports video analysis, quality-preserving format conversion, and smart recompression with customizable settings.
We found that react-native-video-recompression demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
A malicious NuGet package impersonating Sicoob exfiltrated client IDs, PFX passwords, and banking certificates through Sentry telemetry.
Security News
Feross Aboukhadijeh joins TBPN to discuss Socket's $60M Series C, 500%+ ARR growth, AI's impact on open source, and the rise in supply chain attacks.
Security News
OSV withdrew 157 OSV malware reports after automated false positives incorrectly flagged trusted npm and PyPI packages, sending bad records into tools that rely on OSV data.