flutter_multimedia_gallery #

flutter_multimedia_gallery is a reusable Flutter package that renders a mixed media list (images and videos) as:

• an embeddable carousel widget for any screen
• an optional full-screen gallery page on tap
• built-in page indicators and optional thumbnail strip

Features #

• Accept a single list of GalleryItem objects
• Supports image and video media types
• Full-screen gallery page with swipe navigation
• Built with cached_network_image, video_player, video_thumbnail
• Simple API with constructor arguments (no GetX dependency)

Installation #

Add to pubspec.yaml:

dependencies:
  flutter_multimedia_gallery: ^0.1.0

Usage #

import 'package:flutter/material.dart';
import 'package:flutter_multimedia_gallery/flutter_multimedia_gallery.dart';

class MediaDemo extends StatelessWidget {
  const MediaDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final items = <GalleryItem>[
      const GalleryItem(
        url: 'https://images.unsplash.com/photo-1517841905240-472988babdf9?w=1200',
        type: MediaType.image,
        title: 'Dog portrait',
      ),
      const GalleryItem(
        url: 'https://flutter.github.io/assets-for-api-docs/assets/videos/bee.mp4',
        type: MediaType.video,
        title: 'Bee video',
      ),
    ];

    return Scaffold(
      appBar: AppBar(title: const Text('Media')),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: MultimediaGalleryCarousel(items: items),
      ),
    );
  }
}

Open full-screen manually #

Navigator.of(context).push(
  MaterialPageRoute(
    builder: (_) => MultimediaGalleryPage(items: items, initialIndex: 0),
  ),
);

Data model #

GalleryItem(
  url: 'https://example.com/media.jpg',
  type: MediaType.image, // or MediaType.video
  thumbnailUrl: 'https://example.com/thumb.jpg', // optional
  title: 'Optional title',
  id: 'optional-id',
)

Notes #

• Pass absolute URLs or file paths in GalleryItem.url.
• For video entries, thumbnailUrl improves thumbnail loading speed.
• Replace GitHub metadata in pubspec.yaml with your repository URLs before publish.