PHPackages                             denis156/notification-listener - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. denis156/notification-listener

ActiveNativephp-plugin[Utility & Helpers](/categories/utility)

denis156/notification-listener
==============================

Capture system-wide notifications in real-time and manage 'Notification Access' permissions on Android.

1.0.0(1mo ago)148MITKotlinPHP ^8.2

Since May 7Pushed 1mo agoCompare

[ Source](https://github.com/denis156/notification-listener)[ Packagist](https://packagist.org/packages/denis156/notification-listener)[ RSS](/packages/denis156-notification-listener/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

NotificationListener Plugin for NativePHP Mobile (v3)
=====================================================

[](#notificationlistener-plugin-for-nativephp-mobile-v3)

[![PHP Version](https://camo.githubusercontent.com/9eaefa9ec28d407e59ee5b58fa972adc74e6d591a453dbdd44612f5c430a024f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737376262343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/)[![Laravel Version](https://camo.githubusercontent.com/e7e8d925e0671ce7f284ff2af4571db768c1b074e60dedcf1c9635066e6ac695/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e7825323025324625323031332e782d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com)[![NativePHP](https://camo.githubusercontent.com/d3fbf228d39a2cd6443b67d238dcb38f3a2bdf6d3291378cab5b36b74aa616e1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4e61746976655048502d76332d346634366535)](https://nativephp.com)[![Platform Android](https://camo.githubusercontent.com/c101d2fc2bfddc9d93bd990d3065106cf6e80b48ba7ee8a89b0b0585b0095080/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506c6174666f726d2d416e64726f69642d3344444338343f6c6f676f3d616e64726f6964266c6f676f436f6c6f723d7768697465)](https://developer.android.com/)[![Author](https://camo.githubusercontent.com/2e6ff2b4196424087f8eb41bcce18db1921588342dc41823bff29618814d2a60/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f417574686f722d64656e69733135362d626c75653f6c6f676f3d676974687562)](https://github.com/denis156)[![License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

Plugin khusus **Android** untuk menangkap notifikasi sistem secara real-time dan mengelola izin "Notification Access". Sangat berguna untuk aplikasi yang membutuhkan integrasi mendalam dengan notifikasi perangkat lain seperti aplikasi monitoring transaksi, otomasi pesan, atau log sistem.

Caution

**PENAFIAN (DISCLAIMER):**Plugin ini memiliki kemampuan untuk membaca konten notifikasi dari aplikasi lain di perangkat pengguna. Penyalahgunaan plugin ini untuk aktivitas mata-mata (spying), pencurian data, atau pelanggaran privasi adalah **DILARANG KERAS**. Pengembang (denis156) **TIDAK BERTANGGUNG JAWAB** atas segala penyalahgunaan yang dilakukan oleh pihak ketiga.

Fitur Unggulan
--------------

[](#fitur-unggulan)

- **Real-time Capture**: Mendengarkan notifikasi masuk secara instan dari aplikasi apa pun (WhatsApp, Perbankan, E-wallet, dll).
- **Metadata Lengkap**: Mengambil Judul, Isi Pesan, Nama Paket Aplikasi (`com.whatsapp`, dll), dan Timestamp.
- **Manajemen Izin**: Menyediakan shortcut native untuk membuka halaman "Notification Access" di pengaturan Android secara langsung.
- **Background Persistence**: Berjalan sebagai layanan latar belakang (Service) yang tetap aktif meskipun aplikasi tidak di foreground.
- **V3 Bridge Standards**: Menggunakan struktur direktori `resources/` yang sepenuhnya kompatibel dengan NativePHP Plugin Kit v3.

Instalasi
---------

[](#instalasi)

Tambahkan plugin ke proyek Laravel Anda melalui Composer:

```
composer require denis156/notification-listener
```

Daftarkan plugin di proyek NativePHP Anda untuk mengaktifkan fungsionalitas native:

```
php artisan native:plugin:register denis156/notification-listener
```

Jalankan build untuk mengkompilasi plugin ke dalam aplikasi native:

```
php artisan native:run android
```

Penggunaan
----------

[](#penggunaan)

### Sisi PHP (Laravel/Inertia/Livewire)

[](#sisi-php-laravelinertialivewire)

Gunakan facade `NotificationListener` untuk mengecek status dan meminta izin:

```
use Denis156\NotificationListener\Facades\NotificationListener;

// 1. Cek apakah izin akses notifikasi sudah diberikan
$isGranted = NotificationListener::getStatus();

// 2. Buka pengaturan sistem Android jika belum diizinkan
if (! $isGranted) {
    NotificationListener::requestPermission();
}
```

### Menangkap Notifikasi (Event Listener)

[](#menangkap-notifikasi-event-listener)

Setiap kali notifikasi masuk, plugin akan memicu event `NotificationReceived`. Anda bisa menangkapnya menggunakan Listener Laravel:

```
namespace App\Listeners;

use Denis156\NotificationListener\Events\NotificationReceived;

class LogIncomingNotification
{
    public function handle(NotificationReceived $event)
    {
        // Data yang tersedia:
        // $event->title        (Judul Notifikasi)
        // $event->body         (Isi Pesan)
        // $event->app_package  (Nama Paket Aplikasi, misal: com.whatsapp)
        // $event->captured_at  (Timestamp saat diterima)
    }
}
```

### Sisi JavaScript (Vue/React/Inertia)

[](#sisi-javascript-vuereactinertia)

Anda juga bisa memanggil fungsi native langsung dari frontend:

```
import { notificationListener } from '@denis156/notification-listener';

// Ambil status izin
const isGranted = await notificationListener.getStatus();

// Minta izin (Buka pengaturan)
if (!isGranted) {
    await notificationListener.requestPermission();
}
```

Panduan Debugging
-----------------

[](#panduan-debugging)

Jika notifikasi tidak masuk atau status selalu `false`:

1. **Pantau Log Native**: Gunakan `php artisan native:tail` untuk melihat aktivitas bridge dan log dari Android Service.
2. **Aktivasi Manual**: Pada beberapa perangkat, izin harus diaktifkan manual di: `Settings > Apps > Special app access > Notification access`
3. **Optimasi Baterai**: Pastikan aplikasi Anda tidak dibatasi oleh fitur penghemat baterai Android agar Service tetap berjalan di background.

Struktur Direktori (Standar v3)
-------------------------------

[](#struktur-direktori-standar-v3)

```
packages/denis156/notification-listener/
├── nativephp.json          # Manifest Plugin & Bridge Functions
├── src/                    # Kode PHP (Service Provider, Facade, Events)
└── resources/
    ├── android/src/        # Kode Kotlin (NotificationListenerService)
    └── boost/guidelines/   # Instruksi spesifik untuk AI assistants

```

Lisensi
-------

[](#lisensi)

[MIT License](LICENSE)

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance93

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

33d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5195b9f01c0fbce97c71c6437c1a3745af9b41d02866e644d27872b36f1b8bcc?d=identicon)[denis156](/maintainers/denis156)

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/denis156-notification-listener/health.svg)

```
[![Health](https://phpackages.com/badges/denis156-notification-listener/health.svg)](https://phpackages.com/packages/denis156-notification-listener)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)