smart_video_info 1.2.0

Ultra-fast video metadata extraction powered by Smart FFmpeg Engine. No CLI, no process spawning - direct native FFmpeg API.

smart_video_info

Ultra-fast video metadata extraction for Flutter, powered by Smart FFmpeg Engine.

Features

• ⚡ No FFmpeg CLI — Direct native API access
• ⚡ No process spawning — Zero subprocess overhead
• ⚡ Extremely fast — Metadata extraction in <20ms
• ⚡ Lightweight — Minimal footprint
• ⚡ Batch processing — Extract metadata from multiple files efficiently

Installation

dependencies:
  smart_video_info: ^1.0.0

Usage

import 'package:smart_video_info/smart_video_info.dart';

// Single file
final info = await SmartVideoInfoPlugin.getInfo('/path/to/video.mp4');
print('Resolution: ${info.resolution}');  // 1920x1080
print('Duration: ${info.duration}');       // 0:02:00.000000
print('Codec: ${info.codec}');             // h264
print('FPS: ${info.fps}');                 // 30.0
print('Has Audio: ${info.hasAudio}');      // true

// Batch processing (more efficient for multiple files)
final infos = await SmartVideoInfoPlugin.getBatch([
  '/path/to/video1.mp4',
  '/path/to/video2.mp4',
]);

// Check if file is supported
final supported = await SmartVideoInfoPlugin.isSupported('/path/to/file');

// Custom timeout
final info = await SmartVideoInfoPlugin.getInfo(
  '/path/to/video.mp4',
  timeout: Duration(seconds: 5),
);

Available Properties

Property	Type	Description
width	int	Video width in pixels
height	int	Video height in pixels
duration	Duration	Video duration
codec	String	Video codec (h264, hevc, etc.)
bitrate	int	Bitrate in bits/second
fps	double	Frames per second
rotation	int	Rotation in degrees
container	String	Container format (mp4, mkv, etc.)
audioCodec	String?	Audio codec if present
sampleRate	int?	Audio sample rate in Hz
channels	int?	Number of audio channels
hasAudio	bool	Has audio track
hasSubtitles	bool	Has subtitle tracks
streamCount	int	Total stream count

Computed Properties

• resolution — Resolution string ("1920x1080")
• aspectRatio — Width/height ratio
• isLandscape — Width > height
• isPortrait — Height > width

Platform Support

Platform	Status
Android	✅ Supported
iOS	✅ Supported
macOS	✅ Supported
Windows	✅ Supported

Example App

A complete example application is included in the example/ directory. It demonstrates:

• Video file selection using native file picker
• Metadata extraction and display
• Performance metrics
• Error handling
• Material 3 UI design

Run the example:

cd example
flutter run -d macos  # or android, ios, windows

See example/README.md for more details.

Benchmarks

Average metadata extraction time:
Smart Video Info: 14ms
video_player init: 82ms

License

MIT