https://github.com/thatlinuxguyyouknow/turboshark

Multi-threaded download manager
https://github.com/thatlinuxguyyouknow/turboshark

Last synced: 6 days ago
JSON representation

Multi-threaded download manager

• Host: GitHub
• URL: https://github.com/thatlinuxguyyouknow/turboshark
• Owner: ThatLinuxGuyYouKnow
• Created: 2024-12-04T22:23:16.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-08-23T18:07:39.000Z (11 months ago)
• Last Synced: 2025-08-24T04:09:36.533Z (11 months ago)
• Language: Dart
• Homepage:
• Size: 884 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Turbo Shark: A Multithreaded Download Manager

[![Flutter](https://img.shields.io/badge/Flutter-%2302569B.svg?style=for-the-badge&logo=flutter&logoColor=white)](https://flutter.dev/)

[![Dart](https://img.shields.io/badge/Dart-%230175C2.svg?style=for-the-badge&logo=dart&logoColor=white)](https://dart.dev/)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

Turbo Shark is a Flutter-based multithreaded download manager designed to efficiently download files by breaking them into segments and downloading them concurrently. This approach significantly speeds up the download process, especially for large files.

![🚧](image.png)

## Features

-   **Multithreaded Downloading:** Utilizes Dart isolates to download file segments concurrently, improving download speed.

-   **Progress Tracking:** Provides real-time progress updates for each download.

-   **Download States:** Tracks the state of each download (e.g., in progress, done, failed).

-   **Customizable Segment Count:** Allows you to specify the number of segments to use for downloading.

-   **User-Friendly UI:** Simple and intuitive user interface using custom drawer for navigation.

-   **Theme Support:**  Supports dark and light themes.

 

## Core Logic

The core download functionality is encapsulated within the `ConcurrentFileDownloader` class. This class is responsible for:

1.  **Segmenting Files:** Dividing large files into smaller segments for concurrent download.

2.  **Concurrent Downloads:** Utilizing Dart isolates to download these segments simultaneously, improving speed.

3.  **Progress Updates:** Sending real-time progress information back to the main thread to update the UI.

4.  **State Management:** Tracking the state of each download (in progress, complete, failed) and updating the user interface accordingly.

## Dependencies

The following pub.dev packages are used in this project:

-   `provider`: For state management.

-   `google_fonts`: For custom fonts in the UI.

You can add these dependencies to your `pubspec.yaml` file:

```yaml

dependencies:

  flutter:

    sdk: flutter

  provider: ^6.1.1

  google_fonts: ^6.1.0

```

## Usage

1.  **Clone the repository:**

    ```bash

    git clone https://github.com/ThatLinuxGuyYouKnow/turbo-shark

    ```

2.  **Navigate to the project directory:**

    ```bash

    cd turbo_shark

    ```

3.  **Install dependencies:**

    ```bash

    flutter pub get

    ```

4.  **Run the app:**

    ```bash

    flutter run

    ```

## Known Issues/Limitations

-   **Error Handling:** The current error handling is basic. More robust error handling and retry mechanisms can be implemented.

-   **Resuming Downloads:** The current implementation doesn't support resuming interrupted downloads.

-   **UI Polishing:** The UI could be improved with better feedback on loading states and error conditions.

-   **Platform Specifics:** Further platform-specific optimizations might be needed for optimal performance.

-   **Testing:** Further testing would help to find bugs.

## Contributing

Contributions are always welcome! If you have any ideas for improvements or find any bugs, feel free to submit a pull request.