Metadata-Version: 2.1
Name: sun
Version: 1.3.5
Summary: Tray notification applet for informing about package updates in Slackware
Home-page: https://gitlab.com/dslackw/sun
Author: dslackw
Author-email: d.zlatanidis@gmail.com
License: UNKNOWN
Keywords: tray,notify,slackware,desktop
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Desktop Environment
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Software Distribution
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: System :: Software Distribution
Requires-Python: >=3.7
Provides-Extra: optional
Provides-Extra: docs
Provides-Extra: tests
License-File: LICENSE.txt

.. contents:: Table of Contents:

About
-----

Let's SUN!


SUN (Slackware Update Notifier) is a tray notification applet for informing about
package updates in Slackware and CLI tool for monitoring upgraded packages.

.. image:: https://gitlab.com/dslackw/images/raw/master/sun/sun.png
    :target: https://gitlab.com/dslackw/sun

How works
---------

Actually read the two dates of ChangeLog.txt files one the server and a local by counting
how many packages have been upgraded, rebuilt or added.

SUN works with `slackpkg <http://www.slackpkg.org/>`_ as well with `slpkg <https://dslackw.gitlab.io/slpkg>`_
 

Installing
----------

.. code-block:: bash

    Required root privileges

    $ tar xvf sun-1.3.5.tar.gz
    $ cd sun-1.3.5
    $ ./install.sh

    Installed as Slackware package


Usage
-----

| Choose ONE http mirror from '/etc/slackpkg/mirrors' file.
| NOTE: ftp mirrors not supported.

Gtk menu icon
-------------

Add sun in your windows manager session startup.

| As for xfce:
| Settings Manager --> Session and Startup --> Application Autostart --> +Add

.. code-block:: bash

    [Add application]

    Name: sun
    Description: Slackware Update Notifier
    Command: /usr/bin/sun_gtk &

    Click [Ok]

    Click Menu --> System --> SUN (Slackware Update Notifier)
    An icon will appear in the panel, right click in SUN icon to show menu.

    Thats it.

CLI
---

.. code-block:: bash

    $ sun help
    SUN (Slackware Update Notifier) - Version: 1.3.5

    Usage: sun [OPTION]

    Optional arguments:
      help     display this help and exit
      start    start sun daemon
      stop     stop sun daemon
      restart  restart sun daemon
      check    check for software updates
      status   sun daemon status
      info     os information

    $ sun start
    Starting SUN daemon:  /usr/bin/sun_daemon &

    $ sun stop
    Stopping SUN daemon:  /usr/bin/sun_daemon

    $ sun status
    SUN is not running

    $ sun check
    3 software updates are available

    samba-4.1.17-x86_64-1_slack14.1.txz:  Upgraded.
    mozilla-firefox-31.5.0esr-x86_64-1_slack14.1.txz:  Upgraded.
    mozilla-thunderbird-31.5.0-x86_64-1_slack14.1.txz:  Upgraded.


Configuration files
-------------------

.. code-block:: bash

    /etc/sun/sun.conf
        General configuration of sun


Donate
------

If you feel satisfied with this project and want to thanks me make a donation.

.. image:: https://gitlab.com/dslackw/images/raw/master/donate/paypaldonate.png
   :target: https://www.paypal.me/dslackw


Copyright
---------

- Copyright 2015-2022 © Dimitris Zlatanidis
- Slackware® is a Registered Trademark of Patrick Volkerding.
- Linux is a Registered Trademark of Linus Torvalds.


