File Magic Number

A Flutter package to detect file types based on their magic number instead of relying on MIME types. Works on Flutter for mobile, desktop, and web without requiring native code.

🚀 Features #

• Detects file types using their magic number (signature bytes)
• Supports Flutter on Android, iOS, macOS, Windows, Linux, and Web
• No need for native plugins
• Lightweight and easy to extend with custom signatures

📌 Installation #

Add the dependency to your pubspec.yaml:

dependencies:
  file_magic_number: latest_version

Then for Flutter, run:

flutter pub get

🛠️ Usage #

Detect a file type from bytes #

import 'package:file_magic_number/file_magic_number.dart';

void main() async {
  final bytes = Uint8List.fromList([0x25, 0x50, 0x44, 0x46]);
  final MagicNumberType fileType = MagicNumber.detectFileType(bytes);
  print(fileType);
}

Detect a file type from file_picker #

Integrating file_magic_number with file_picker allows you to easily detect the type of a file selected by the user without relying on MIME types. You can use file_picker to open the file dialog and then pass the file's bytes to MagicNumber.detectFileType to identify its type. Here's how you can do it:

import 'package:file_magic_number/file_magic_number.dart';
import 'package:file_picker/file_picker.dart';

void main() async {
  FilePickerResult? result = await FilePicker.platform.pickFiles(withData: true);

  if (result != null) {
    final MagicNumberType fileType = MagicNumber.detectFileType(result.files.single.bytes!);
    print(fileType);
  }
}

🎯 Supported File Types #

📌 Contributing #

Feel free to contribute by adding more file signatures or improving the implementation. Fork the repo and submit a PR!

📜 License #

This project is licensed under the MIT License.