PHPackages                             laravel-nodenotifierdesktop/laravel-nodenotifierdesktop - 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. [Mail & Notifications](/categories/mail)
4. /
5. laravel-nodenotifierdesktop/laravel-nodenotifierdesktop

ActiveLibrary[Mail & Notifications](/categories/mail)

laravel-nodenotifierdesktop/laravel-nodenotifierdesktop
=======================================================

Laravel package for desktop notifications using node-notifier

1.0.4(9mo ago)111MITPHPPHP ^8.1

Since Aug 6Pushed 9mo agoCompare

[ Source](https://github.com/idpcks/laravel-nodenotifier-desktop)[ Packagist](https://packagist.org/packages/laravel-nodenotifierdesktop/laravel-nodenotifierdesktop)[ RSS](/packages/laravel-nodenotifierdesktop-laravel-nodenotifierdesktop/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (4)Used By (0)

Laravel Node Notifier Desktop
=============================

[](#laravel-node-notifier-desktop)

A Laravel package that provides desktop notifications using node-notifier. This package allows you to send desktop notifications from your Laravel application to the user's computer.

Features
--------

[](#features)

- 🖥️ Cross-platform desktop notifications (Windows, macOS, Linux)
- 🎨 Customizable notification icons and sounds
- 📝 Multiple notification types (success, error, warning, info)
- 🔧 Easy configuration
- 🚀 Simple installation with Artisan command
- 📊 Logging support
- ⚡ Laravel 12 ready with modern PHP features

Requirements
------------

[](#requirements)

- PHP 8.1 or higher
- Laravel 9.0, 10.0, 11.0, or 12.0
- Node.js 12+ (for desktop notifications)
- npm (comes with Node.js)

### Platform Support

[](#platform-support)

- ✅ Windows 10/11
- ✅ macOS (latest versions)
- ✅ Linux (Ubuntu, CentOS, etc.)

Installation
------------

[](#installation)

### 1. Install the package via Composer:

[](#1-install-the-package-via-composer)

```
composer require laravel-nodenotifierdesktop/laravel-nodenotifierdesktop
```

### 2. Publish the configuration file (optional):

[](#2-publish-the-configuration-file-optional)

```
php artisan vendor:publish --tag=laravel-nodenotifierdesktop-config
```

### 3. Install Node.js dependencies:

[](#3-install-nodejs-dependencies)

```
php artisan desktop-notifier:install
```

This command will:

- ✅ Check Node.js and npm availability
- ✅ Install `node-notifier` in the vendor directory
- ✅ Copy the notifier script to the correct location
- ✅ Test the installation with a sample notification

Uninstallation
--------------

[](#uninstallation)

### Manual Uninstall

[](#manual-uninstall)

Jika Anda ingin menghapus package ini dari project Laravel:

```
# 1. Remove via Composer
composer remove laravel-nodenotifierdesktop/laravel-nodenotifierdesktop

# 2. Remove config file (if published)
rm config/laravel-nodenotifierdesktop.php

# 3. Remove vendor directory
rm -rf vendor/laravel-nodenotifierdesktop

# 4. Clear caches
php artisan config:clear
php artisan cache:clear
composer dump-autoload
```

### Automatic Uninstall Script

[](#automatic-uninstall-script)

Atau gunakan script uninstall otomatis:

**Untuk Linux/macOS:**

```
php uninstall.php
```

**Untuk Windows:**

```
uninstall.bat
```

Script ini akan:

- ✅ Menghapus package via Composer
- ✅ Menghapus file konfigurasi
- ✅ Menghapus folder vendor package
- ✅ Memeriksa dan menghapus registrasi manual di config/app.php
- ✅ Membersihkan cache
- ✅ Mencari penggunaan package dalam kode
- ✅ Memberikan panduan langkah selanjutnya

**📖 Dokumentasi lengkap:** Lihat [UNINSTALL.md](UNINSTALL.md) untuk panduan detail dan troubleshooting.

### Windows Users - Important Notes

[](#windows-users---important-notes)

The package includes special handling for Windows:

- ✅ **Automatic Windows detection** - No extra configuration needed
- ✅ **Fixed command line escaping** - Resolves JSON parsing errors
- ✅ **Proper path handling** - Works with Windows file paths
- ✅ **Enhanced error messages** - Clear troubleshooting information

If you encounter issues on Windows:

1. **Ensure Node.js is in your PATH:**

    ```
    node --version
    npm --version
    ```
2. **Run as Administrator** if you get permission errors:

    ```
    # Run your terminal as Administrator, then:
    php artisan desktop-notifier:install --force
    ```
3. **Check Windows notifications are enabled:**

    - Go to Settings > System > Notifications & actions
    - Ensure notifications are enabled for your system

Configuration
-------------

[](#configuration)

The configuration file is located at `config/laravel-nodenotifierdesktop.php`. You can customize:

- Default icons for different notification types
- Default sound settings
- Notification timeout
- Node.js path
- Logging preferences

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
use LaravelNodeNotifierDesktop\Facades\DesktopNotifier;

// Send a basic notification
DesktopNotifier::notify('Hello', 'This is a test notification');

// Send different types of notifications
DesktopNotifier::success('Success!', 'Operation completed successfully');
DesktopNotifier::error('Error!', 'Something went wrong');
DesktopNotifier::warning('Warning!', 'Please check your input');
DesktopNotifier::info('Info', 'Here is some information');
```

### Advanced Usage

[](#advanced-usage)

```
// With custom options
DesktopNotifier::notify('Custom Notification', 'With custom settings', [
    'icon' => '/path/to/custom/icon.png',
    'sound' => false,
    'timeout' => 10000
]);

// Using dependency injection
public function someMethod(DesktopNotifierService $notifier)
{
    $notifier->success('Success!', 'Operation completed');
}
```

### In Controllers

[](#in-controllers)

```