Skip to content

README.md

Latest commit

 

History

History
96 lines (69 loc) · 3.86 KB

README.md

File metadata and controls

96 lines (69 loc) · 3.86 KB
Raw

Vidly Logo

Vidly

A Premium, High-Performance Video & Audio Downloader
Built with Flutter, GetX, and Clean Architecture.

📖 Introduction

Vidly is a high-performance media utility designed for speed and a seamless user experience. By utilizing a powerful Third-Party Media Parsing API, Vidly can accurately extract high-quality video and audio streams from a wide range of web sources. Beyond downloading, Vidly features a built-in playback engine, allowing you to enjoy your saved content directly within the app.

📱 Visual Overview

Core UI Flow

Splash Screen Home Analysis
Splash Home
Initializing App URL Extraction

Download & Playback

Ongoing Tasks Completed Library Media Playback
Ongoing Finished Preview
Active Progress Offline Storage Video/Audio Player

✨ Features

🔍 Advanced Media Extraction

  • Third-Party API Integration: Leverages a robust cloud-based parser to fetch direct media links, ensuring high compatibility and fast metadata extraction.
  • Smart Intent Handling: Automatically detects and parses URLs shared from other applications via system intents.

⚡ Real-Time Notifications

  • Instant Feedback: Features an advanced notification system that provides immediate "Download Started" alerts.
  • Live Progress Tracking: Continuous updates via interactive notification progress bars.
  • Rich Previews: Notifications display video thumbnails and allow for "Open File" actions immediately upon completion.

🎬 Integrated Media Player

  • High-Quality Video Playback: Built-in video player supports multiple resolutions and formats ( MP4, MKV, etc.).
  • Audio Playback Engine: Seamlessly play extracted MP3 files with a dedicated audio interface.
  • Offline Access: Play your downloaded media anytime without requiring an internet connection.

🎨 Premium UI/UX

  • Custom Selection UI: A beautifully designed bottom sheet with rounded borders and selection states for choosing quality.
  • Clean Formatting: Easy-to-read resolution labels such as FULL HD (1080p), HD (720p), and SD.

🛠 Tech Stack

  • State Management: GetX (Dependency Injection & Reactive State)
  • Networking: Dio (Handling API requests and file streaming)
  • Local Database: Hive (Persistent download history)
  • Notifications: Awesome Notifications (Custom UI for progress and media previews)
  • **Playback **: Video Player & Just Audio

📂 Project Structure

lib/
 ├── controller/      # Business logic for home, downloads, and playback state
 ├── core/            # App branding, constants, and global utilities
 ├── data/            
 │    ├── providers/  # API service implementations for third-party parsing
 │    └── repository/ # Data abstraction and task management
 ├── views/           # UI Screens (Home, Preview, Downloads) and custom widgets
 └── main.dart        # Entry point and dependency initialization