First guide

User will be guided to prepare, install and run Customizer. Read the instructions carefully before following. It's concise and short enough already. If in doubt, read FAQ.

1. What to prepare

Before installing and running Customizer, user must prepare the following.

• able to use command line i.e. apt-get, dpkg and Bash shell built-in commands
• a host system running Ubuntu or any supported host system
• a Live CD of Ubuntu or any supported ISO image

IMPORTANT Use the same release and architecture of both host system and Live CD, but not necessarily be the same operating system.

For example, a user can run Xubuntu 14.04 32-bit host system to remaster Ubuntu Mini Remix 14.04 32-bit ISO image. Using same release (14.04) and same architecture (32-bit).

2. How to install

For older OS versions, install the following optimal dependencies.

sudo apt-get install git build-essential fakeroot make binutils g++ \
python python-dev python-qt4 pyqt4-dev-tools squashfs-tools \
xorriso x11-xserver-utils xserver-xephyr qemu-kvm dpkg-dev \
debhelper qt4-dev-tools qt4-linguist-tools isolinux \
--no-install-recommends

For Ubuntu 18.04 and 19.04, install the following optimal dependencies instead.

sudo apt-get install qt5-default qt5-qmake git build-essential \
fakeroot make binutils g++ python python-dev pyqt5-dev-tools \
squashfs-tools xorriso x11-xserver-utils xserver-xephyr qemu-kvm \
dpkg-dev debhelper isolinux python3-dev qttools5-dev-tools \
--no-install-recommends

Then, download the latest release from master branch and install it.

wget https://github.com/kamilion/Customizer/archive/master.tar.gz
tar zxvf master.tar.gz
cd customizer-master && make deb
sudo apt install --fix-broken
cd .. && sudo dpkg --install customizer*.deb

Installing via dpkg will make removing the program easier, by running sudo dpkg -r customizer in Terminal. For other releases and methods, refer to Installation.

3. How to run

Run the following command in the Terminal.

sudo customizer-gui

To run CLI, replace customizer-gui with customizer -h instead.

To run GUI from application menu or application launcher of choice, use a valid authorization method. Recent releases of Ubuntu use pkexec, since gksu has been deprecated. Customizer provides a launcher that runs pkexec /usr/sbin/customizer-gui by default.

The graphical user interface (GUI) provides most features and convenience. The command-line interface (CLI) provides minimal features and accepts one option at a time without arguments.

To learn how to configure and use Customizer, see Features.