flet-media-scanner

A Flet extension for Android MediaStore integration — save, list, and delete videos, audio, and images in the device Gallery / Music / Pictures without requiring broad storage permissions.

Built entirely with native Kotlin using Android's MediaStore APIs directly — no third-party Flutter packages required.

Author: Fazi Gondal · nextinpk@gmail.com

Requirements

Architecture

Python API  →  Dart bridge  →  Kotlin (native MediaStore)

Unlike typical Flet extensions that wrap Flutter packages, this extension bypasses the Flutter package ecosystem entirely and calls Android's MediaStore APIs directly from Kotlin — giving you a lighter, faster, and fully self-contained plugin.

Supported Formats

🎬 Video → Movies/<album>/

🎵 Audio → Music/<album>/

🖼 Image → Pictures/<album>/

MIME type is resolved automatically from the file extension — no manual configuration needed.

Installation

pip install flet-media-scanner

Setup

Register the extension in your app's pyproject.toml:

[tool.flet.extensions]
flet_media_scanner = "flet_media_scanner.Extension"

Usage

import os
import flet as ft
from flet_media_scanner import MediaScanner, SaveResult

async def main(page: ft.Page):
    scanner = MediaScanner()
    storage = ft.StoragePaths()
    page.services.extend([scanner, storage])
    page.update()

    # Use ft.StoragePaths to resolve the correct cache directory (cross-device safe)
    cache_dir = await storage.get_application_cache_directory()

    # ── Video ──────────────────────────────────────────────────────────────
    result: SaveResult = await scanner.save_video(
        os.path.join(cache_dir, "video.mp4"),
        file_name="my_video.mp4",
        album="MyApp",
    )
    if result.success:
        print(f"Saved to Gallery: {result.content_uri}")

    for v in await scanner.list_videos(album="MyApp"):
        print(v["display_name"], v["content_uri"])

    # ── Audio ──────────────────────────────────────────────────────────────
    result = await scanner.save_audio(
        os.path.join(cache_dir, "song.mp3"),
        file_name="song.mp3",
        album="MyApp",
    )
    if result.success:
        print(f"Saved to Music: {result.content_uri}")

    for t in await scanner.list_audio(album="MyApp"):
        print(t["display_name"], t["mime_type"])

    # ── Image ──────────────────────────────────────────────────────────────
    result = await scanner.save_image(
        os.path.join(cache_dir, "photo.jpg"),
        file_name="photo.jpg",
        album="MyApp",
    )
    if result.success:
        print(f"Saved to Pictures: {result.content_uri}")

    for img in await scanner.list_images(album="MyApp"):
        print(img["display_name"], img["size"])

    # ── Delete (works for any media type) ──────────────────────────────────
    deleted = await scanner.delete_media("content://media/external/video/media/123")
    print("Deleted:", deleted)

ft.run(main)

API Reference

MediaScanner (Service)

Add to page.services before calling any methods.

🎬 Video

🎵 Audio

🖼 Image

🗑 Delete

Common save_* parameters

SaveResult (dataclass)

Returned by all save_* methods.

List item fields

Each dict returned by list_videos(), list_audio(), and list_images() contains:

content_uri · display_name · mime_type · relative_path · size · date_added · date_modified

Changelog

License

MIT © Fazi Gondal