npmpackage.info

Gathering detailed insights and metrics for @capacitor-community/privacy-screen

@capacitor-community/privacy-screen - 6.0.0 | npmpackage.info

@capacitor-community/privacy-screen

⚡️ Capacitor plugin that protects your app from displaying a screenshot in Recents screen/App Switcher.

6.0.0

MIT

Swift

46.63 kB

3.8

Installations

npm install @capacitor-community/privacy-screen

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

20.18.0

NPM Version

10.8.2 Pull Requests

Open

4

Total

61

Closed

7

Merged

50

Issues

Open

8

Total

55

Closed

47

Releases

v6.0.0

Updated on Jan 28, 2025

v5.2.1

Updated on Aug 16, 2024

v5.2.0

Updated on Aug 12, 2024

v5.1.3

Updated on Aug 09, 2024

v5.1.2

Updated on Aug 08, 2024

v5.1.1

Updated on Jul 17, 2024

View All 29 releases

Languages

Swift

Java

TypeScript

Ruby

Objective-C

JavaScript

Swift (50.32%)

Java (21.2%)

TypeScript (17.3%)

Ruby (4.96%)

Objective-C (3.78%)

JavaScript (2.43%)

Developer

capacitor-community

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

93 Stars

136 Commits

26 Forks

8 Watchers

2 Branches

28 Contributors

Updated on May 26, 2025

Maintainers

View All 28 Contributors

Package Meta Information

Latest Version

6.0.0

Package Id

@capacitor-community/privacy-screen@6.0.0

Unpacked Size

46.63 kB

Size

11.18 kB

File Count

NPM Version

10.8.2

Node Version

20.18.0

Published on

Jan 28, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

@capacitor/core

Dev Dependencies

eslint rimraf rollup prettier swiftlint typescript @capacitor/cli @capacitor/ios @capacitor/core standard-version @capacitor/docgen @capacitor/android @ionic/eslint-config prettier-plugin-java @ionic/prettier-config @ionic/swiftlint-config

Privacy Screen

@capacitor-community/privacy-screen

Capacitor Privacy Screen Plugin

Introduction

⚡️ Capacitor plugin that protects your app from displaying a screenshot in Recents screen/App Switcher.

On Android, this plugin sets the FLAG_SECURE flag to treat the content of the window as secure, preventing it from appearing in screenshots or from being viewed on non-secure displays.
On iOS, this plugin hides the webview window when the app is no longer active and loses focus (UIApplicationWillResignActiveNotification) so that a gray screen is shown instead. It also prevents screenshots (a black screen will be captured).

Using the Camera Plugin

Disabling screenshots can interfere with plugins that hide the WebView like the Camera plugin. To avoid issues call disable before using a plugin and then enable after you are finished.

Maintainers

Maintainer	GitHub	Social
Robin Genz	robingenz	@robin_genz

Installation

npm install @capacitor-community/privacy-screen
npx cap sync

Configuration

These configuration values are available:

Prop	Type	Description	Default	Since
`enable`	`boolean`	Configure whether the plugin should be enabled from startup. Only available for Android and iOS.	`true`
`imageName`	`string`	Configure whether the plugin should display a custom image from assets instead of a default background gray for the privacy screen. Only available for iOS.	`""`
`contentMode`	`'center' \| 'scaleToFill' \| 'scaleAspectFit' \| 'scaleAspectFill'`	Configure the content mode of displayed image. Only available for iOS.	`"center"`
`preventScreenshots`	`boolean`	Configure whether the plugin should prevent screenshots if enabled. Only available for iOS.	`true`	5.2.0

Examples

In capacitor.config.json:

1{
2  "plugins": {
3    "PrivacyScreen": {
4      "enable": true,
5      "imageName": "Splashscreen",
6      "contentMode": "scaleAspectFit",
7      "preventScreenshots": false
8    }
9  }
10}

In capacitor.config.ts:

1/// <reference types="@capacitor-community/privacy-screen" />
2
3import { CapacitorConfig } from '@capacitor/cli';
4
5const config: CapacitorConfig = {
6  plugins: {
7    PrivacyScreen: {
8      enable: true,
9      imageName: "Splashscreen",
10      contentMode: "scaleAspectFit",
11      preventScreenshots: false,
12    },
13  },
14};
15
16export default config;

Demo

A working example can be found here: robingenz/capacitor-plugin-demo

Usage

The plugin only needs to be installed. The protection is enabled by default.
However, you have the option to enable/disable the protection:

1import { PrivacyScreen } from '@capacitor-community/privacy-screen';
2
3const enable = async () => {
4  await PrivacyScreen.enable();
5};
6
7const disable = async () => {
8  await PrivacyScreen.disable();
9};

API

enable()
disable()
addListener('screenRecordingStarted', ...)
addListener('screenRecordingStopped', ...)
addListener('screenshotTaken', ...)
removeAllListeners()
Interfaces

enable()

1enable() => Promise<void>

Enables the privacy screen protection.

Only available for Android and iOS.

Since: 1.1.0

disable()

1disable() => Promise<void>

Disables the privacy screen protection.

Only available for Android and iOS.

Since: 1.1.0

addListener('screenRecordingStarted', ...)

1addListener(eventName: 'screenRecordingStarted', listenerFunc: () => void) => Promise<PluginListenerHandle>

Called when the screen recording is started.

Only available on iOS for now.

Param	Type
`eventName`	`'screenRecordingStarted'`
`listenerFunc`	`() => void`

Returns: Promise<PluginListenerHandle>

Since: 3.0.2

addListener('screenRecordingStopped', ...)

1addListener(eventName: 'screenRecordingStopped', listenerFunc: () => void) => Promise<PluginListenerHandle>

Called when the screen recording is stopped.

Only available on iOS for now.

Param	Type
`eventName`	`'screenRecordingStopped'`
`listenerFunc`	`() => void`

Returns: Promise<PluginListenerHandle>

Since: 3.0.2

addListener('screenshotTaken', ...)

1addListener(eventName: 'screenshotTaken', listenerFunc: () => void) => Promise<PluginListenerHandle>

Called when the screenshot is taken.

Only available on iOS for now.

Param	Type
`eventName`	`'screenshotTaken'`
`listenerFunc`	`() => void`

Returns: Promise<PluginListenerHandle>

Since: 3.2.0

removeAllListeners()

1removeAllListeners() => Promise<void>

Remove all listeners for this plugin.

Since: 3.0.2

Interfaces

PluginListenerHandle

Prop	Type
`remove`	`() => Promise<void>`

Changelog

See CHANGELOG.md.

License

See LICENSE.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

9

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

9

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

4

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

3.8

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More