Download the PHP package soloterm/notify-laravel without Composer
On this page you can find all versions of the php package soloterm/notify-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package notify-laravel
Notify for Laravel
Laravel integration for soloterm/notify - send desktop notifications from Artisan commands via terminal OSC escape sequences.
This package was built to support Solo, your all-in-one Laravel command to tame local development.
| OSC Notifications (Ghostty) | OSC Notifications (iTerm2) |
| macOS Fallback | Fireworks (iTerm2) |
| Progress Bars (Ghostty) | Progress Bars (iTerm2) |
Installation
The service provider will be auto-discovered by Laravel.
Quick Start
Artisan Command
Exit Code Mode
Pipe the exit status of any command to get automatic success/failure notifications:
Facade
The Notify facade provides convenient access to all notification features:
Scheduler Integration
Notify when scheduled tasks complete - perfect for long-running commands:
Event Listener
Automatically notify when Artisan commands complete:
Log Channel
Send log messages as desktop notifications:
Then use it:
Log levels map to urgency:
emergency,alert,critical,error→ Critical urgencywarning,notice→ Normal urgencyinfo,debug→ Low urgency
Note: This log channel is designed for CLI usage (Artisan commands, queue workers, scheduled tasks). In web requests, there's no terminal attached, so notifications are silently skipped. For web request logging, use a different channel in your stack.
Progress Bars
Display progress in the terminal tab/taskbar for long-running commands:
Progress States
Terminal Support
Progress bars are supported in:
- Windows Terminal - Full support
- Ghostty - Full support (1.2+)
- iTerm2 - Full support (3.6.6+)
- ConEmu/Mintty - Full support
Queue Worker Notifications
Get notified when queue workers start processing and when they stop:
SendsNotifications Trait
Add notification capabilities to any Artisan command:
Configuration
Publish the config file:
This creates config/notify.php:
Terminal Compatibility
| Terminal | Support | Notes |
|---|---|---|
| iTerm2 | ✅ | macOS |
| Kitty | ✅ | Cross-platform, full-featured |
| WezTerm | ✅ | Cross-platform |
| Ghostty | ✅ | Cross-platform |
| tmux | ✅ | Requires config below |
| Alacritty | ⚠️ | Falls back to system notifications |
| Terminal.app | ⚠️ | Falls back to system notifications |
tmux Configuration
For notifications to work inside tmux, add to ~/.tmux.conf:
Then reload: tmux source-file ~/.tmux.conf
Requirements
- PHP 8.1+
- Laravel 10, 11, or 12
- A supported terminal emulator (or system notification tools for fallback)
Related Projects
Part of the SoloTerm ecosystem:
- Solo - All-in-one Laravel command for local development
- Screen - Pure PHP terminal renderer
- Dumps - Laravel command to intercept dumps
- Grapheme - Unicode grapheme width calculator
- Notify - PHP package for desktop notifications via OSC escape sequences
- TNotify - Standalone, cross-platform CLI for desktop notifications
- VTail - Vendor-aware tail for Laravel logs
License
The MIT License (MIT).
Support
This is free! If you want to support me:
- Check out my courses:
- Help spread the word about things I make
Credits
Developed by Aaron Francis.
- Twitter: https://twitter.com/aarondfrancis
- Website: https://aaronfrancis.com
- YouTube: https://youtube.com/@aarondfrancis
All versions of notify-laravel with dependencies
illuminate/console Version ^10.0|^11.0|^12.0
illuminate/support Version ^10.0|^11.0|^12.0
soloterm/notify Version ^0.1.0|^1.0