=====================================================================
                       Mu-AppLauncher - Readme & Info
===============================================================================

Author:      Mark Ulrich
Email:       markulrich@gmx.de
License:     GNU General Public License v2.0 or later (GPLv2+)
Version:     1.0.0
Platform:    Linux (Tailored for IceWM and minimalist X11/Wayland environments)
Language:    Vala / GTK+ 3

-------------------------------------------------------------------------------
1. Description
-------------------------------------------------------------------------------
Mu-AppLauncher is a lightweight, high-performance, and deeply customizable 
application deck built with Vala and GTK3. It provides a clean, grid-based 
layout to launch your favorite applications without bloating your system. 

It features native desktop background anchoring for X11/IceWM, automatic 
edge autohide triggers, dynamic size allocations, icon management, and custom 
shortcut generation. It is also designed to be fully crash-proof under Wayland.

-------------------------------------------------------------------------------
2. Command Line Interface (CLI) Options
-------------------------------------------------------------------------------
Usage: mu-applauncher [OPTIONS]

Options:
  -h, --help            Show this help message and exit
  -d, --desktop         Run in permanent desktop widget mode (anchored below)
  -t, --top             Force positioning as a centered top bar
  -b, --bottom          Force positioning as a centered bottom bar
  -l, --left            Force positioning as a centered left bar
  -r, --right           Force positioning as a centered right bar
  -u, --autohide        Force activation of the automatic edge autohide trigger
  -c, --config <path>   Use a custom configuration file path
  -a, --apps <path>     Use a custom folder for *.desktop applications
  -p, --picker          Open the Icon Manager window directly
  -n, --new             Open the Shortcut Creator window directly

Examples:
  # Launch as a permanent left-aligned sidebar widget under IceWM:
  mu-applauncher -d -l

  # Launch as a hidden bottom bar that slides out when the mouse touches the edge:
  mu-applauncher -b -u

-------------------------------------------------------------------------------
3. Build & Installation Instructions
-------------------------------------------------------------------------------
Before compiling, ensure you have the Vala compiler and GTK3 development 
libraries installed on your system (e.g., `sudo apt install valac libgtk-3-dev`).

To build and manage the project, use the following Makefile commands:

  make clean && make
    Cleans the workspace and compiles the application binary.

  sudo make install
    Installs the binary executable system-wide to /usr/local/bin.

  make dist
    Packs the entire independent project source code, asset structure, 
    and licensing documentation into a standard source tarball:
    -> mu-applauncher-1.0.0.tar.gz

  make deb
    Compiles the binary and builds a fully compliant, production-ready 
    Debian repository installation package:
    -> mu-applauncher_1.0.0_amd64.deb

  sudo dpkg -i mu-applauncher_1.0.0_amd64.deb
    Installs your compiled Debian package natively via the system package manager.

-------------------------------------------------------------------------------
4. Configuration Structure (config.rc)
-------------------------------------------------------------------------------
The configuration file is automatically generated or read from:
~/.mu-applauncher/config.rc

Available structural layout keys:
  [Launcher]
  X=100                       # Manual X coordinate (used if Center=false)
  Y=120                       # Manual Y coordinate (used if Center=false)
  Center=false                # Centers window (auto-disabled if manual X/Y given)
  BottomBar=false             # Position as bottom bar panel
  TopBar=false                # Position as top bar panel
  LeftBar=false               # Position as left bar panel
  RightBar=false              # Position as right bar panel
  Autohide=false              # Enable automatic mouse edge triggers
  IconSize=64                 # Pixel resolution of the application grid icons
  FontSize=12                 # Text label font size in points
  Columns=3                   # Maximum columns in the layout grid
  GridSpacing=25              # Padding spacing between grid cells
  TextColor=#bbbb77           # Label font color hex code
  HoverColor=rgba(255,255,255,0.15) # Button cell mouse hover overlay transparency
  BorderColor=#666666         # Outer canvas container border frame hex code
  BorderWidth=2               # Outer line weight thickness in pixels
  BackgroundImage=/path/to.png # Visual skin wallpaper backdrop asset target
  IgnoreBgInDesktopMode=true  # Disables drawing background image in desktop mode
  Bold=true                   # Forces bold weight fonts on labels
  HideTextUntilHover=false    # Shows application names only when hovered
  AutoCloseOnLeave=true       # Exits launcher immediately when mouse leaves canvas
===============================================================================