screen_capturer's Introduction

screen_capturer

This plugin allows Flutter desktop apps to take screenshots.

screen_capturer

Platform Support

Linux	macOS	Windows
✔️	✔️	✔️

Quick Start

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  screen_capturer: ^0.1.2

dependencies:
  screen_capturer:
    git:
      url: https://github.com/leanflutter/screen_capturer.git
      ref: main

Windows requirements

Be sure to modify your Visual Studio installation and ensure that "C++ ATL for latest v142 build tools (x86 & x64)" is installed!

Usage

macOS

Change the file ios/Runner/DebugProfile.entitlements or ios/Runner/Release.entitlements as follows:

Required only for sandbox mode.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>com.apple.security.app-sandbox</key>
	<true/>
+	<key>com.apple.security.temporary-exception.mach-register.global-name</key>
+	<string>com.apple.screencapture.interactive</string>
</dict>
</plist>

import 'package:screen_capturer/screen_capturer.dart';

CapturedData? capturedData = await screenCapturer.capture(
  mode: CaptureMode.region, // screen, window
  imagePath: '<path>',
);

Please see the example app of this plugin for a full example.

Platform Differences

CaptureMode

Name	Description	Linux	macOS	Windows
`region`	Drag the cursor around an object to form a rectangle.	✔️	✔️	✔️
`screen`	Capture the entire screen.	✔️	✔️	✔️
`window`	Select a window, that you want to capture. (linux capture only the current window)	➖	✔️	✔️