CondinAPT MiniOS - minios-linux/minios-live GitHub Wiki

CondinAPT in MiniOS: Integration Guide

This document describes the specific aspects of using CondinAPT in the MiniOS build system.

📚 Main Documentation: For basic CondinAPT features, see the main document CondinAPT.md

Table of Contents

Integration with MiniOS Build System

Usage in MiniOS Modules

CondinAPT is a standard tool for package installation in MiniOS modules. It integrates into the build process through the standard module interface.

In the module installation script (install):

#!/bin/bash
set -e

# Load MiniOS library
. /minioslib || exit 1

# Install packages via CondinAPT
/linux-live/condinapt \
    -l "$CWD/packages.list" \
    -c /linux-live/build.conf \
    -m /linux-live/condinapt.map

MiniOS Module Structure

Each module in /linux-live/scripts/ follows a standardized structure:

XX-module-name/
├── packages.list                     # Package list with conditions
├── install                           # Installation script (uses CondinAPT)
├── rootcopy-install/                 # (optional) Files to copy
└── rootcopy-postinstall/             # (optional) Files after installation

MiniOS Configuration

Contents of condinapt.map in MiniOS

d=DISTRIBUTION
da=DISTRIBUTION_ARCH
dt=DISTRIBUTION_TYPE
dp=DISTRIBUTION_PHASE
de=DESKTOP_ENVIRONMENT
pv=PACKAGE_VARIANT
kt=KERNEL_TYPE
kb=KERNEL_BPO
ka=KERNEL_AUFS
kbd=KERNEL_BUILD_DKMS
lo=LOCALE
ml=MULTILINGUAL
kl=KEEP_LOCALES

MiniOS Configuration Variables

Main variables from build.conf:

  • DISTRIBUTION - target distribution (bookworm, trixie, jammy, noble)
  • DISTRIBUTION_ARCH - architecture (amd64, i386, i386-pae)
  • DESKTOP_ENVIRONMENT - desktop environment (core, flux, xfce, lxqt)
  • PACKAGE_VARIANT - package variant (minimum, standard, toolbox, ultra)
  • KERNEL_TYPE - kernel type (none, default, rt, cloud)
  • KERNEL_BPO - use backports kernel (true/false)
  • KERNEL_AUFS - AUFS support (true/false)
  • KERNEL_BUILD_DKMS - build DKMS modules (true/false)
  • LOCALE - system locale (C, en_US, ru_RU, es_ES, pt_BR)
  • MULTILINGUAL - multilingual support (true/false)
  • KEEP_LOCALES - keep locales (true/false)

Automatically calculated variables (from minioslib):

  • DISTRIBUTION_TYPE - distribution type (debian, ubuntu) - automatically determined based on DISTRIBUTION
  • DISTRIBUTION_PHASE - distribution phase - automatically determined:
    • legacy: stretch, buster, orel, bionic
    • current: bullseye, bookworm, focal, jammy, noble
    • future: trixie, kali-rolling, sid

Usage in Modules

Multimedia Module Example

packages.list:

# Basic multimedia codecs - always
gstreamer1.0-plugins-base
gstreamer1.0-plugins-good

# Additional codecs - not for minimal variant
gstreamer1.0-plugins-bad -pv=minimum
gstreamer1.0-plugins-ugly -pv=minimum
gstreamer1.0-libav -pv=minimum

# Professional tools - only for toolbox and ultra
audacity +{pv=toolbox|pv=ultra}
kdenlive +{pv=toolbox|pv=ultra} +{de=xfce|de=lxqt}

---

# Distribution-specific packages from backports
ffmpeg @bookworm-backports +d=bookworm

Driver Module Example

packages.list:

# Basic drivers
mesa-utils
xserver-xorg-video-all

# NVIDIA drivers - only for non-free distributions
nvidia-driver +d=bookworm -{pv=minimum&de=core}

# AMD drivers - for modern distributions
firmware-amd-graphics +{d=trixie|d=noble}
mesa-vulkan-drivers +{d=trixie|d=noble}

# Old drivers - for old systems
xserver-xorg-video-radeon +d=bookworm

Localization Module Example

packages.list:

# Basic locales - always
locales

# Russian localization
language-pack-ru +lo=ru_RU
fonts-liberation +lo=ru_RU
firefox-esr-l10n-ru +lo=ru_RU +{de=xfce|de=lxqt}

# Multilingual support
task-russian +ml=true +lo=ru_RU
hunspell-ru +ml=true +lo=ru_RU

# Keeping locales
vlc-l10n +kl=true +{pv=toolbox|pv=ultra}

# Regional settings for different locales
language-pack-pt +lo=pt_BR
language-pack-de +lo=de_DE
language-pack-fr +lo=fr_FR

Examples for MiniOS

Advanced Filter Usage in MiniOS

packages.list:

# DKMS modules with kernel and distribution conditions
ntfs3-dkms -ka=true -dp=legacy -d=trixie -d=sid
zfs-dkms +{pv=toolbox|pv=ultra} +da=amd64 +kbd=true -kt=none

# Drivers for old systems
broadcom-sta-dkms -d=jammy -ka=true -da=i386
aufs-dkms +dt=debian +dp=legacy

# Exclusion for new distributions
realtek-rtl8821cu-dkms -d=trixie -d=sid
firmware-b43-installer -d=bionic

# Complex alternatives with filters
exfatprogs -pv=minimum || exfat-utils -pv=minimum && exfat-fuse -pv=minimum

# Localization with exclusions and conditions
vlc-l10n -lo=en_US +{pv=toolbox|pv=ultra}
language-pack-gnome-ru-base +lo=ru_RU +dt=ubuntu
language-pack-gnome-ru-base +ml=true +dt=ubuntu
language-pack-gnome-ru-base +kl=true +dt=ubuntu

Optimization for MiniOS

Grouping by functionality:

#=== Core System ===
systemd +pv=standard +pv=toolbox +pv=ultra
dbus

#=== Desktop Environment ===
xfce4-panel +de=xfce
lxqt-panel +de=lxqt
fluxbox +de=flux

#=== Applications by Variant ===
firefox-esr +{pv=standard|pv=toolbox|pv=ultra}
thunderbird +{pv=toolbox|pv=ultra}
libreoffice +pv=ultra

Integration with MiniOS Build Process

Module Environment Variables

Within the MiniOS module context, the following variables are available:

  • $CWD - current module directory
  • $LIVEKITNAME - system name (usually "minios")
  • $MODULE - current module name

Using minioslib

#!/bin/bash
set -e

# Load MiniOS library
. /minioslib || exit 1

# Check module conditions
if [ "$PACKAGE_VARIANT" = "minimum" ] && [ "$DESKTOP_ENVIRONMENT" = "core" ]; then
    echo "Skipping module for minimal core build"
    exit 0
fi

# Install packages
/linux-live/condinapt \
    -l "$CWD/packages.list" \
    -c /linux-live/build.conf \
    -m /linux-live/condinapt.map

For complete information on CondinAPT features, refer to the main document CondinAPT.md