flutter_saucenao_img_search 1.0.0

A library that allows you to search anime image's source in flutter.

Introduction

An convenient way to use SauceNAO API in Flutter/Dart

Quick start

Install

A convenient way to add denpendency of this package to your project is run pub command in your project

flutter pub add flutter_saucenao_img_search

Besides, You can still update the Flutter project pubspec.yaml file to add package dependency.

dependencies:
  ...
  flutter_saucenao_img_search:
    git:
      url: https://github.com/nfnfgo/flutter_saucenao_img_search.git
      ref: main

After updating pubspec.yaml, you may need to restart your IDE.

Search Picture by URI

import 'package:flutter_saucenao_img_search/flutter_saucenao_img_search.dart';
import 'package:flutter_test/flutter_test.dart';

void main() async {
  {
    // Create ImageSearcher
    ImageSearcher imgSearcher = ImageSearcher(
      searcherConfig: ImageSearcherConfig(
        // Use your own SauceNAO APIKEY instead
          apiKey: 'YOUR_API_KEY_HERE'),
    );

    // Search Picture by uri
    SearchResult? result = await imgSearcher.uri(
      uriStr:
          'https://pbs.twimg.com/media/FmWFWu4agAEGo7P?format=jpg&name=large',
    );

    if (result != null) {
      for (SearchResultItem resultItem in result.resultItemsList) {
        print('-----------------------------------------------');
        print('Thumbnail: ${resultItem.thumbnailLink}');
        // Actually, the items in resultItemsList could be the subtype of the
        // SearchResult*tem class, such as PixivSearchResultItem, which contains
        // more info of some specified platform
        if (resultItem is PixivSearchResultItem) {
          print('PixivID: ${resultItem.pixivId}');
          print('Pixiv User Page: ${resultItem.artistLink}');
        }
        print('Source Links: ${resultItem.sourceLinksList}');
      }
    }
  }
}

If you run the code in Dart, you could get below output

Thumbnail: https://img1.saucenao.com/res/pixiv/10449/manga/104491469_p1.jpg?auth=ZpchuXwRGpw9dYG3BvU-zg&exp=1674590400
PixivID: 104491469
Pixiv User Page: https://www.pixiv.net/users/212801
Source Links: [https://www.pixiv.net/member_illust.php?mode=medium&illust_id=104491469]
-----------------------------------------------
Thumbnail: https://img3.saucenao.com/booru/0/6/0689c9516d7e95987e34820ece877cd4_2.jpg?auth=luScLjJjXOP6MJ1OHKFWzQ&exp=1674590400
Source Links: [https://danbooru.donmai.us/post/show/5979370, https://yande.re/post/show/1054789, https://gelbooru.com/index.php?page=post&s=view&id=8128874]
-----------------------------------------------
Thumbnail: https://img3.saucenao.com/booru/d/1/d150c1887bd1e0a33a4e014cdca712ba_2.jpg?auth=8n5L2vv1CAitOUWfYWp2JA&exp=1674590400
Source Links: [https://danbooru.donmai.us/post/show/5979362, https://gelbooru.com/index.php?page=post&s=view&id=8128881]

Search Pictures By File

If you want to search pictures on your local device, you could use ImageSeacher.file(). Just replace the code example below

SearchResult? result = await imgSearcher.file(
  File(r'YOUR_FILE_PATH_HERE'),
);

You could also read the package API Reference Document

API Reference Document

https://pub.dev/documentation/flutter_saucenao_img_search/latest/

Advanced Guide

Exception

This package uses some custom Exception class to help you catch and handle Exception more acurately.

You can check Api Reference Document for more info about each custom Exception class.

For More

Search Image Without using SauceNAO API Key