

1)How to install "mklauncher"
2)Uninstall
3)Documentation
4)How to create an ".png" icon


1. How to install "mklauncher"
==============================


GNU/Linux 64 Bits
=================

1)Download "mklauncher" :

    $ wget https://osdn.net/dl/mklauncher/mklauncher-1.0.0-amd64.tar.gz
   
2)Start a session as an administrator :

    $ su -l
   
3)Unzip "mklauncher-1.0.0-amd64.tar.gz", and enter in the folder :

    # tar zxvf mklauncher-1.0.0-amd64.tar.gz
    # cd mklauncher-1.0.0-amd64
   
4)Install "mklauncher" :

    # ./install


GNU/Linux 32 Bits
=================

1)Download "mklauncher" :

    $ wget https://osdn.net/dl/mklauncher/mklauncher-1.0.0-i386.tar.gz
   
2)Start a session as an administrator :

    $ su -l
   
3)Unzip "mklauncher-1.0.0-i386.tar.gz", and enter in the folder :

    # tar zxvf mklauncher-1.0.0-i386.tar.gz
    # cd mklauncher-1.0.0-i386
   
4)Install "mklauncher" :

    # ./install


FreeBSD 64 Bits
===============

1)Download "mklauncher" :

    $ wget https://osdn.net/dl/mklauncher/mklauncher-1.0.0-freebsd-amd64.tar.gz
   
2)Start a session as an administrator :

    $ su -l
   
3)Unzip "mklauncher-1.0.0-freebsd-amd64.tar.gz", and enter in the folder :

    # tar zxvf mklauncher-1.0.0-freebsd-amd64.tar.gz
    # cd mklauncher-1.0.0-freebsd-amd64
   
4)Install "mklauncher" :

    # ./install


FreeBSD 32 Bits
===============

1)Download "mklauncher" :

    $ wget https://osdn.net/dl/mklauncher/mklauncher-1.0.0-freebsd-i386.tar.gz
   
2)Start a session as an administrator :

    $ su -l
   
3)Unzip "mklauncher-1.0.0-freebsd-i386.tar.gz", and enter in the folder :

    # tar zxvf mklauncher-1.0.0-freebsd-i386.tar.gz
    # cd mklauncher-1.0.0-freebsd-i386
   
4)Install "mklauncher" :

    # ./install


******************************
NOTE : It is recommended to install the following optional packages, for more functionality :

xdg-utils   : To be able to use the "xdg-open" command.
gksu        : To run applications in "root" mode.
ImageMagick : To be able to use the "iconrb" command.


GNU/Linux
---------

# apt install xdg-utils gksu imagemagick

# dnf install xdg-utils gksu ImageMagick

# yum install xdg-utils gksu ImageMagick


FreeBSD
-------

# pkg install xdg-utils gksu ImageMagick

******************************


2. Uninstall
============

1)Start a session as an administrator :

    $ su -l

2)Simply run the "uninstall" command, included in the "mklauncher" package :

    # ./uninstall
    

3. Documentation    
================

To obtain documentation, simply run "mklauncher" with the following parameter :

    # mklauncher -help


4. How to create an ".png" icon
===============================

To create a custom icon, you must follow the following procedure :

1)Take a screenshot that contains the desired image.

2)Open the captured image with an image editor, for example "Gimp".

3)Copy an area of 256x256 px, and save how a new "Namefile.png" file.

4)Use the "iconrb" command to create a new file with rounded edges :

    $ iconrb "Namefile.png"
    
    rb-Namefile.png

5)Place this file in an accessible location, example :

    /opt/icons/rb-Namefile.png

6)Use the new PNG icon to create a launcher :

    # mklauncher -n "My app" -e "my_app" -i "/opt/icons/rb-Namefile.png"


_____________________________________________________________________
You can report any defect or request an improvement at this address :

OSDN [https://osdn.net/ticket/newticket.php?group_id=11497]');

_______________________________________________________
You can support this project by sending a donation to :

PayPal [http://mklauncher.osdn.io/en/donate.html]


******************************
NOTE : This file is part of "mklauncher"
                                                                            
See the file COPYING.GPL.txt, included in this distribution, for details about the copyright.                                         
******************************

