Search packages, repositories and app categories

Package detailsv0.7.0

twitch_api

A wrapper in pure Dart to connect to Twitch.tv using OAuth implicit authentication.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
51
Likes
21
Pub points
150

Install package

flutter pub add twitch_api

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A pure Dart package that provides a wrapper for connecting to Twitch.tv's API using OAuth implicit authentication. It simplifies integration with Twitch's services, enabling developers to authenticate users and access public data such as streams, channels, and user information. The package supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux, making it ideal for cross-platform applications. Designed for ease of use, it handles the complexities of OAuth flows while maintaining security and compatibility with Twitch's current authentication standards.

Use cases

  • Integrating Twitch login functionality
  • Fetching live stream data
  • Accessing user and channel information
  • Building Twitch-based social apps
  • Creating dashboards for streamers

Key features

  • OAuth implicit authentication
  • Cross-platform support
  • Pure Dart implementation
  • Simple API interface
  • Secure token handling

Suitable for

  • Flutter apps needing Twitch integration
  • Stream monitoring tools
  • Twitch community platforms
  • Developer tools for Twitch content
  • Multi-platform applications

Considerations

  • Requires proper Twitch app registration
  • Limited to OAuth implicit flow
  • Dependent on Twitch API rate limits
  • Needs careful handling of refresh tokens
  • Not suitable for server-side operations

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

twitch_api

Dart Pub Coverage Status style: lint

A wrapper in pure Dart to connect to Twitch.tv using OAuth implicit authentication.

All the endpoints are implemented as defined in the Twitch API Reference

Getting started

NOTE: This package is in its early stage, please be patient until more methods are implemented or do not hesitate to open a merge request if you added support for an endpoint. Currently I do not have a roadmap of the endpoint I am going to add in priority so do not hesitate to open an issue to make suggestions depending of your needs.

To use this package you will need to register an application on the Twitch developer console to get a client ID.

After registering your application you will need to instantiate the TwitchClient class from the package with your clientId and your redirectUri .

import 'package:twitch_api/twitch_api.dart';

final _twitchClient = TwitchClient(
  clientId: clientId,
  redirectUri: redirectUri,
);

Now that you have initialized the client the last step before using the method will be to manage the first connection with your twitch account and initialize the token you will receive. You can find a complete example of an implementation using the package flutter_webview_plugin.

const clientId = "<YOUR_CLIENT_ID>";
const redirectUri = "<YOUR_REDIRECT_URL>"; // ex: "http://localhost/"

final _twitchClient = TwitchClient(
  clientId: clientId,
  redirectUri: redirectUri,
);

final _flutterWebviewPlugin = FlutterWebviewPlugin();

// First authentication through a webview
Future<TwitchToken> _openConnectionPage({
  List<TwitchApiScope> scopes = const [],
}) {
  // Listen for url changes to detect redirection on our redirectUri.
  _flutterWebviewPlugin.onUrlChanged.listen((url) {
    if (url.startsWith(_twitchClient.redirectUri)) {
      // After you got to your redirectUri you can initialize the token.
      _twitchClient.initializeToken(TwitchToken.fromUrl(url));

      // Close the webview
      _flutterWebviewPlugin.close();
    }
  });

  // When the webview is closed pop the current route.
  _flutterWebviewPlugin.onDestroy.listen((_) => Navigator.pop(context));

  // Get authorization URL for the connection with the webview.
  final _url = _twitchClient.authorizeUri(scopes);

  return Navigator.push(
    context,
    MaterialPageRoute(
      builder: (context) => WebViewPage(_url.toString()),
    ),
  ).then((_) => _twitchClient.twitchHttpClient.validateToken());
}

Now you are ready to use the methods implemented in Supported Endpoints section.

Supported Endpoints

Ads
  • [x] Start Commercial
Analytics
  • [x] Get Extension Analytics
  • [x] Get Game Analytics (Documentation in progress)
Bits
  • [x] Get Bits Leaderboard
  • [x] Get Cheermotes
  • [x] Get Extension Transactions
Channels
  • [x] Get Channel Information
  • [x] Modify Channel Information
  • [x] Get Channel Editors
Channel Points
  • [x] Create Custom Rewards
  • [x] Delete Custom Reward
  • [x] Get Custom Reward
  • [x] Get Custom Reward Redemption
  • [x] Update Custom Reward
  • [x] Update Redemption Status
Chat
  • [x] Get Channel Emotes
  • [x] Get Global Emotes
  • [x] Get Emote Sets
  • [x] Get Channel Chat Badges
  • [x] Get Global Chat Badges
  • [x] Get Chat Settings
  • [ ] Update Chat Settings
Clips
  • [x] Create Clip
  • [x] Get Clips
Entitlements
  • [ ] Create Entitlement Grants Upload URL
  • [ ] Get Code Status
  • [ ] Get Drops Entitlements
  • [ ] Redeem Code
Extensions
  • [ ] Get Extension Configuration Segment
  • [ ] Set Extension Configuration Segment
  • [ ] Set Extension Required Configuration
  • [ ] Send Extension PubSub Message
  • [ ] Get Live Channels
  • [ ] Get Extension Secrets
  • [ ] Create Extension Secret
  • [ ] Send Extension Chat Message
  • [ ] Get Extensions
  • [ ] Get Released Extensions
  • [ ] Get Extension Bits Products
  • [ ] Update Extension Bits Product
EventSub
  • [ ] Create EventSub Subscription
  • [ ] Delete EventSub Subscription
  • [ ] Get EventSub Subscriptions
Games
  • [x] Get Top Games
  • [x] Get Games
Hype Train
  • [ ] Get Hype Train Events
Moderation
  • [ ] Check AutoMod Status
  • [ ] Get Banned Events
  • [ ] Get Banned Users
  • [ ] Get Moderators
  • [ ] Get Moderator Events
Polls
  • [ ] Get Polls
  • [ ] Create Poll
  • [ ] End Poll
Predictions
  • [ ] Get Predictions
  • [ ] Create Prediction
  • [ ] End Prediction
Schedule
  • [ ] Get Channel Stream Schedule
  • [ ] Get Channel iCalendar
  • [ ] Update Channel Stream Schedule
  • [ ] Create Channel Stream Schedule Segment
  • [ ] Update Channel Stream Schedule Segment
  • [ ] Delete Channel Stream Schedule Segment
Search
  • [x] Search Categories
  • [x] Search Channels
Streams
  • [ ] Get Stream Key
  • [x] Get Streams
  • [ ] Create Stream Marker
  • [ ] Get Stream Markers
Subscriptions
  • [x] Get Broadcaster Subscriptions
Tags
  • [ ] Get All Stream Tags
  • [ ] Get Stream Tags
  • [ ] Replace Stream Tags
Users
  • [x] Get Users
  • [ ] Update User
  • [x] Get Users Follows
  • [ ] Create User Follows
  • [ ] Delete User Follows
  • [ ] Get User Block List
  • [ ] Block User
  • [ ] Unblock User
  • [ ] Get User Extensions
  • [ ] Get User Active Extensions
  • [ ] Update User Extensions
Videos
  • [ ] Get Videos
  • [ ] Delete Videos
Webhooks
  • [ ] Get Webhook Subscriptions

Contributors

TesteurManiak
Guillaume Roux
matteo0158
LaCremeDoree
LewisHolliday
Lewis Holliday

Categories

Dependencies

Dependency list 3 items

Source repository

Projects using this package

No data available yet.