flic_button 0.1.9 icon indicating copy to clipboard operation
flic_button: ^0.1.9 copied to clipboard

An interface to the flic2 button.

flic_button #

A flutter and dart version of the Shortcut Labs Flic button protocol to expose Android and iOS Flic2 functionality to Flutter Apps.

Please see the official Flic developer docs for more info on Flic2

Device support #

Currently supported #

Planned support #

  • Maybe I'll add Flic (original) support, but I don't know how many of those buttons are around of if it's worth it.
  • Hopefully, someone from Flic or Shortcut Labs can take up the mantle and merge it all into one library. I did this myself out of necessity and thought it would be nice to let others use it too.

Usage #

The plugin allows you to search for Flic 2, connect to Flic 2, disconnect and forget Flic 2 buttons Then, more usefully, receive callbacks from the Flic 2 library to tell you someone pressed the button.

At this time, there is no background service to keep the service alive and callback into flutter if destroyed. However, as long as the flutter app remains alive, so will the Flic 2 support.

Getting Started #

Change the minSdkVersion for Android #

Flic2 buttons are compatible only from version 19 of Android SDK so you should change this in android/app/build.gradle:

Android {
  defaultConfig {
     minSdkVersion: 19

Add permissions for Bluetooth #

We need to add the permission to use Bluetooth and access location:


In the android/app/src/main/AndroidManifest.xml let’s add:

    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>


In the ios/Runner/Info.plist let’s add a number of permissions to enable bluetooth and location access. Also needed, at the bottom, is the ability to access BLE in the background...

        <string>Need BLE permission</string>  
        <string>Need BLE permission</string>  
        <string>Need Location permission</string>  
        <string>Need Location permission</string>  
        <string>Need Location permission</string>

For location permissions on iOS see more at: https://developer.apple.com/documentation/corelocation/requesting_authorization_for_location_services

A simple usage example:

import 'package:flic_button/flic_button.dart';

class ButtonListener with Flic2Listener {
  void onButtonClicked(Flic2ButtonClick buttonClick) {
    print('button ${buttonClick.button.uuid} clicked');

void main() {
  //DON'T FORGET - you will need to ask for permissions for bluetooth and location to search and use
  //FLIC2 as it is a bluetooth button (use your fave plugin for this yourself)
  // YOU WILL ALSO need to add permissions for bluetooth LE accessories in your iOS and Android implementations
  final plugin = FlicButtonPlugin(flic2listener: ButtonListener());
  _flicPlugin = FlicButtonPlugin(flic2listener: this);
  _flicPlugin.invokation.then((value) {
    // NOTE: value will be true that it initialised unless you already did (iOS can't stop so will be false a lot)
    // which is why I am choosing to ignore the 'value here'
    // have invoked the plugin here, get all the buttons to connect them up
    return _flicPlugin.getFlic2Buttons();
  }).then((value) {
    if (value.isEmpty) {
      // you don't have buttons in the manager, initiate a scan to find and connect a new one
    } else {
      // here we have the buttons, listen to all of them
      for (Flic2Button button in value) {
        // listen to them all!

Features and bugs #

Please file feature requests and bugs at the issue tracker.

License #

Dart flic_button by Douglas Brain is licensed under MIT LICENCE

pub points


verified publisher icondarkerwaters.co.uk

An interface to the flic2 button.

Repository (GitHub)


API reference


Icon for licenses.unknown (LICENSE)


flutter, logging


Packages that depend on flic_button