README.md

@wuilmerj24/screen-protector

A NativeScript plugin to protect sensitive content from screen capture and recording.
This plugin provides API methods to block screenshots and detect screen recording events — with native support for both iOS and Android.

---

📦 Installation

npm install @wuilmerj24/screen-protector

---

📱 Platform Support

Feature	Android	iOS
Block Screenshots	✅	✅
Block Screen Recording	✅	✅
Detect Screenshots	❌	✅
Detect Screen Recording	❌	✅

---

🚀 Usage

Import the plugin

import { ScreenProtector } from '@wuilmerj24/screen-protector';

Initialize and use

const protector = new ScreenProtector();

// Block screenshots
protector.lockScreenShoots();

// Optionally set up listeners (iOS only)
protector.setScreenshootEvent(() => {
  console.log('📸 Screenshot detected (iOS)');
});

protector.setScreenRecorderEvent((isRecording: boolean) => {
  console.log('📹 Screen recording changed:', isRecording);
});

To remove protection

protector.unlockScreenShoots();

// Remove observers (iOS only)
protector.removeScreenShootObserver();
protector.removeScreenRecorderObserver();

---

🧪 API

lockScreenShoots(): boolean

Blocks screenshots and screen recordings:

• On iOS, it uses a secure UITextField to force the system to blur the screen.
• On Android, it sets FLAG_SECURE to prevent all screen capture mechanisms.

---

unlockScreenShoots(): boolean

Restores the normal behavior, allowing screenshots again.

---

setScreenshootEvent(callback: () => void): void

iOS only

Registers a listener that fires when the user takes a screenshot.

---

setScreenRecorderEvent(callback: (isRecording: boolean) => void): void

iOS only

Registers a listener that tracks whether screen recording is active (true or false).

---

removeScreenShootObserver(): void

iOS only

Removes the screenshot observer.

---

removeScreenRecorderObserver(): void

iOS only

Removes the screen recording observer.

---

📝 License

Apache License Version 2.0

---

👨‍💻 Author

Maintained by @wuilmerj24

License

Apache License Version 2.0