

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


1. How to compile and install
=============================

-)Use the source code file :

mklauncher-1.0.0-source.tar.gz

-)Install the packages "fpc" (Free Pascal) and "binutils". The instructions for the current GNU/Linux or FreeBSD distribution must be followed.


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

# apt install fpc binutils

# dnf install fpc binutils


CentOS

# yum install binutils

Download "fpc-3.0.4.x86_64-linux.tar"

ftp://mirror.freemirror.org/pub/fpc/dist/3.0.4/x86_64-linux/fpc-3.0.4.x86_64-linux.tar
https://www.freepascal.org/down/x86_64/linux.html

# tar xf fpc-3.0.4.x86_64-linux.tar
# cd fpc-3.0.4.x86_64-linux
# sh install.sh


FreeBSD
-------

# pkg install fpc binutils


Compile and install "mklauncher"
--------------------------------

-)Start a session as an administrator :

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

    # tar zxvf mklauncher-1.0.0-source.tar.gz
    # cd mklauncher-1.0.0-source

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

    # cd GNU_LINUX
    # ./compile
    # ./install

FreeBSD
-------

    # cd FREEBSD
    # ./compile
    # ./install


******************************
NOTE : That some distributions use "fpc-laz" instead of "fpc".

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

******************************
NOTE : A "beesu" package is available in "CentOS".

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

******************************
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
============

To uninstall "mklauncher", the following steps must be followed :    

-)Start a session as an administrator :

    $ su -l

-)Unzip "mklauncher-1.0.0-source.tar.gz", and enter in the folder :

    # tar zxvf mklauncher-1.0.0-source.tar.gz
    # cd mklauncher-1.0.0-source

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

    # cd GNU_LINUX
    # ./uninstall

FreeBSD
-------

    # cd FREEBSD
    # ./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.                                         
******************************

