http_file_transfer_server 0.0.1

A simple HTTP file transfer server for Flutter apps. Upload, download, and manage media files with built-in web interface and BLoC integration.

HTTP File Transfer Server

A simple and clean HTTP file transfer server Flutter package. Directly usable without delegate pattern complexity.

Features

• ✅ Simple and clean API
• ✅ File upload and download
• ✅ Web interface included
• ✅ Video and audio file support
• ✅ Automatic device name detection
• ✅ No delegate pattern - no complex code

Installation

Add to your pubspec.yaml:

dependencies:
  http_file_transfer_server: ^0.0.1

Basic Usage

import 'dart:io';
import 'package:http_file_transfer_server/http_file_transfer_server.dart';

// Create server
final outputDir = Directory('/path/to/files');
final server = HttpTransferServer(
  port: 8080,
  outputDirectory: outputDir,
  maxFileSizeMb: 100.0,
  deviceName: 'My Device',
);

// Start server
await server.start();

// Get local IP
final ip = await server.getLocalIp();
print('Server running: http://$ip:8080');

// Stop server
await server.stop();

API Endpoints

• GET / - Web interface
• GET /list - File list (JSON)
• POST /upload - Upload file (multipart/form-data)
• GET /download?path=xxx - Download file
• GET /remove?path=xxx - Delete file

File Operations

// Scan directory and load files
await server.scanDirectory();

// Get file list
final files = server.files;

// Add file
server.addFile(FileItem(
  path: '/path/to/file.mp3',
  title: 'My Song',
  size: 1024000,
  type: 'audio',
));

// Remove file
server.removeFile('/path/to/file.mp3');

Supported File Types

Audio Files

• MP3, WAV, FLAC, AAC, OGG, M4A, WMA

Video Files

• MP4, AVI, MOV, MKV, FLV, WMV, WEBM

Web Interface

The server automatically provides a web interface. By going to http://ip:port in your browser:

• You can view files
• Upload files with drag and drop
• Download files
• Delete files

Customization

Maximum File Size

final server = HttpTransferServer(
  maxFileSizeMb: 200.0, // 200 MB limit
  // ...
);

Full Example

See example/main.dart for detailed usage example.