Added base CLI implementation (#29). But I think better to move it into separate repo, somethig like jolicode/jolinotif-cli.

Installation

Install package globally:

$ composer global require jolicode/jolinotif

Note! Make sure to place the ~/.composer/vendor/bin directory (or the equivalent directory for your OS) in your PATH so the transfer executable can be located by your system. Simply add this directory to your PATH in your ~/.bashrc (or ~/.bash_profile) like this:

$ echo "export PATH=~/.composer/vendor/bin:$PATH" >> ~/.bashrc
$ source ~/.bashrc

This may be a complete edge case, but I needed desktop notifications on the linux subsystem running on windows.

The good news is that the ToastNotifier works fine, but detecting this situation is a little complex it would seem and there are no definitive answers out there.

I couldn't find any information on how to detect the linux subsystem running on windows, but the best thing I could find was:

 $isLinuxOnWindows = mb_strpos(strtolower(php_uname()), 'microsoft') !== false

I have implemented this in my setup by extending the NotifierFactory, and rewriting the methods:

class NotifierFactory extends JoliNotifFactory
{
    /**
     * @return Notifier[]
     */
    public static function getDefaultNotifiers()
    {
        // Don't retrieve notifiers which are certainly not supported on this
        // system. This helps to lower the number of process to run.
        if (OsHelper::isUnix() && !mb_strpos(strtolower(php_uname()), 'microsoft')) {
            return self::getUnixNotifiers();
        }

        return self::getWindowsNotifiers();
    }

    /**
     * @return Notifier[]
     */
    private static function getWindowsNotifiers()
    {
        return [
            new ToasterBashWindowsNotifier(),
            new ToasterNotifier(),
            new NotifuNotifier(),
        ];
    }
}

And then creating a ToasterBashWindowsNotifier that just extends ToasterNotifier:

class ToasterBashWindowsNotifier extends ToasterNotifier
{
    /**
     * {@inheritdoc}
     */
    public function canBeUsed()
    {
        return OsHelper::isUnix() && mb_strpos(strtolower(php_uname()), 'microsoft');
    }
}

and all works now as expected, with notifications popping up as normal.

The only thing I've found is that icons seem to break it at the moment.

I haven't looked in detail, but my guess would be that:

• Notifier expects a path it can resolve in the current OS, so passing a windows style path means the icon doesn't even try to get displayed when running in Linux (it can't find the file). So e.g. passing C:\myapp\myicon.png doesn't work.
• Toast expects a path it can resolve in Windows, and passing a Linux path causes it to fail - so passing mnt/c/myapp/myicon.png doesn't work.

I've tracked this down to the 'setIcon' function on the notification, where it does a 'realpath' which turns to null if a windows path is given on the linux subsystem - fuuuuuu.

Icons aren't 100% important to me, so I can forgo supporting them atm.

I did have a thought that Toast might be able to support some sort of base64 encoded png - but I can't get it to work.

Windows 10 Mozilla & Chrome No Internal 500 Error

The code structure looks like the below.

<?php
	ini_set('display_errors', 1);
	ini_set('display_startup_errors', 1);
	error_reporting(E_ALL | E_STRICT);
	require_once '.../vendor/autoload.php';
	
	use Joli\JoliNotif\Notification;
	use Joli\JoliNotif\NotifierFactory;

// Create a Notifier
	$notifier = NotifierFactory::create();

// Create your notification
	$notification =
		(new Notification())
			->setTitle('Notification title')
			->setBody('This is the body of your notification')
	;

// Send it
	$notifier->send($notification);

Where is the error? Thank you.

Hi, the desktop notifier works fine, but even adding the code resource_path('image.png') the image is not showing. I read some other posts for which it would need required to install other package into the OSX o Windows pc, but this cannot be asked to all users using this feature.

Any solution?

Greate project you got here, I was wondering if its posible to trigger this notifications from a webapp. I tried but the notification doesn't show. If I run the example from the terninal then it shows. Any pointers will be greatly appreciated. From web From terminal

Ubuntu 14..04 Trying to run file with notifier directly - works. Trying to run in cron, like:

• * * * * php /path/notifier.php Nothing happens.

root or my own user - not working log says script is run ok

Can I run it from cron to get result?

I'm using JoliNotif with SnoreNotification on Windows.

When I send a notification, the script then hangs until either the notification is cleared (by clicking it, for example) or the process times-out

Example of a timeout:

   Symfony\Component\Process\Exception\ProcessTimedOutException 

  The process ""W:\app\vendor\jolicode\jolinotif/bin/snoreToast/snoretoast-x86.exe" -m "With Failures" -t "artisan test finished"" exceeded the timeout of 60 seconds.

Using $process->start() instead of $process->run() in the CliBasedNotifier removes the hang.

https://github.com/jolicode/JoliNotif/blob/main/src/Notifier/CliBasedNotifier.php#L88

Is there a reason to use run() instead of start()? (or what about adding an option to specify?)

Is it possible to update to also work with symfony/process v5?

I'm having a dependency issue with other projects that depend on JoliNotif, but have installed symfony/process v5.

This PR adds export-ignore capability via a .gitattributes.

Basically this allows github to only send the relevant source files in the .zip/.tar.gz files when composer is installing them. Doing so limits the file size needed to transfer and keeps unnecessary development files (tests/docs/etc) out of production environments.

You can read more about .gitattributes here

Hi, I've read the docs on cron, as well as #13.

I've performed all the suggested steps but can't get the notifications working from cron:

* * * * * env DISPLAY=:0 php /home/benjamin/script.php

I verified that the cronjob runs fine. I verified my $DISPLAY:

$ echo $DISPLAY
:0

I've run the suggested xhost command as well:

xhost +local:

But same, no notifications. I'm using Zorin OS 15.3, based on Ubuntu 18.04.

Any idea how to make notifications work in cron?

In https://github.com/mikaelbr/node-notifier/commit/61fafc50c387fab2c53f3883af7d53f53209b0c3, they changed the replaced the windows 8+ notifier (Toaster) by a new one: https://github.com/KDE/snoretoast Check whether we would benefit to switch to it inside JoliNotif