Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
en:handbook:genlivecd [2010/08/24 15:41] – lineaen:handbook:genlivecd [2017/01/05 16:32] (current) – two replaced by three hgt
Line 1: Line 1:
-====== Generating a Customised LiveCD ======+====== Generating a Customised LiveCD or LiveUSB====== 
 +//Tazlito// can create your own, personalised version of SliTaz in very little time. It allows you to choose precisely the software packages that you want and make a flavor file (.flavor) with it. You can choose to make your own file starting from a general slitaz flavor (such as base, justx or core), or make it based on an  already customised flavor supplied by the SliTaz community.
  
-//Tazlito// can create your own, personalised SliTaz LiveCD in very little time. You can choose precisely the software packages that you want and the support of flavors permits you to generate a customized LiveCD amended by a list of packages or flavors created by the SliTaz community. Tazlito is a command line tool that is not too demanding, you can have your own ISO image in two commands or burned in one. +Once you've downloaded (and possibly -further- customized) the flavor you chose, you can make an iso-file with it using tazlito, and then burn it to a cd.\\
- +
-\\+
  
 === Overview === === Overview ===
 +Tazlito automates the process of building a customized ISO, and the method is quite straight-forward:
  
-Tazlito automates the process of building a LiveCD, although the method is quite straight-forward: +  - find a template (flavor) to work on ($ tazlito list-flavors) 
- +  - download the template ($ tazlito get-flavor flavor_name) 
-  - download a template (flavor) to work on +  - look at the flavor's packages ($ tazlito show-flavor flavor_name) 
-  - customise its packages +  - extract the flavor ($ tazlito extract-flavor flavor_name) 
-    *  //optional: include additional files, added after the packages// +  - put in a rootfs folder (make one by copying in files from /etc/ to /home/slitaz/distro )  
-  - compress the generated pseudo-file-system +  - add additional files using the folder /home/slitaz/distro/addfiles (optional) 
-  - create an ISO image +  - change options ($ tazlito configure) 
- +  - create the ISO image ($ tazlito gen-distro) 
-\\+  - burn to CD or USB stick ($ tazusb gen-iso2usb) \\
  
 === Notes === === Notes ===
  
-  *  Creating a LiveCD requires a minimum of 256MB of RAM. +  * Note that you can't delete packages, but you can use a stripped-down flavor to build your customized slitaz version.  
-  *  Compressing the file-system with LZMA may take some time. GZip can also be used, though its compression ratio is not as effective.+  * Note that you can modify the distro further by hacking the ISO once created, after which you can make it into a flavor again (see details below)  
 +  * Note that you can add some last changes (that require modification from inside slitaz; like changing appearance, modifying the taskbar, ...) by simply making an additional rootfs file with a usb stick made with the iso of the slitaz version you just made (using the # tazusb writefs lzma command), and then adding it to the extracted iso (using the [[en:handbook:hacklivecd|hacker account]]). You can probably also reinclude these changes finally into your flavor file by means of the # tazlito iso2flavor <your-ISO_image> <your-flavor> command.  
 +  * Creating a LiveCD requires a minimum of 256MB of RAM.  
 +  * Compressing the file-system with LZMA may take some time. GZip can also be used, though its compression ratio is not as effective.
   *  It's possible to create a distribution from the LiveCD or from an installed system. In LiveCD mode, it's advisable to use persistent media or an USB drive to store generated files and save space in RAM.   *  It's possible to create a distribution from the LiveCD or from an installed system. In LiveCD mode, it's advisable to use persistent media or an USB drive to store generated files and save space in RAM.
 +  *  Tazlito is used by developers to generate the official LiveCD. Unlike the (now deprecated tazwok), it is installed by default on SliTaz. Note that you can also use it an a different distribution (non-slitaz) if that linux distro has the necessary packages (they can be downloaded if not). See [[#installing-tazlito-on-another-distribution|the instructions]] at the bottom of the page for more details.\\
  
-  *  Tazlito is used by developers to generate the official LiveCD. The only prerequisite is to have Tazlito installed. It is installed by default on SliTaz, but you can generate from another LiveCD distribution if they have the necessary packages (they can be downloaded if not). See the [[#installing-tazlito-on-another-distribution|instructions]] at the bottom of the page for more details.+===== A customized ISO in three commands =====
  
 +A good way of becoming familiar with Tazlito is to re-build the LiveCD. To do this, download the default //core// flavor (a //.flavor// file that contains all the necessary information to create a LiveCD) and build it with the default options. This takes only three commands and will help to demonstrate the process:
 \\ \\
- +  * Get the default (//core//) flavor (# tazlito get-flavor core) 
-===== A LiveCD in Two Commands ===== +  * Extract the flavor (# tazlito extract-flavor core) 
- +  * Optional: Amend the list of packages or add additional files. 
-A good way of becoming familiar with Tazlito is to re-build the LiveCD. To do this, download the default //core// flavor (a //.flavor// file that contains all the necessary information to create a LiveCD) and build it with the default options. This takes only two commands and will demonstrate the process:+  * Create the LiveCD (# tazlito gen-distro)
 \\ \\
  
-    * Get the default (//core//) flavor: +That's it! You will find the LiveCD ISO image in ///home/slitaz/<version>/distro//.
- +
-  # tazlito get-flavor core +
- +
-    * //Optional: Amend the list of packages or add additional files.// +
- +
-    * Create the LiveCD: +
- +
-  # tazlito gen-distro +
 \\ \\
  
-That's it! You will find the LiveCD ISO image in ///home/slitaz/distro//. +===== The steps laid out in detail... =====
 \\ \\
  
-===== Part I: Downloading a Flavor ===== +====== Part I: Downloading a Flavor ====== 
- +Flavors can be used to build various styles of LiveCDs by containing the list of packages (//distro-packages.list//) and sometimes additional files. This saves you the effort of saving the configuration files and provides a quick way of switching between them. A list of flavors available on the SliTaz servers can be downloaded and updated with Tazlito:
-Flavors can be used to build various styles of LiveCDs by containing the list of packages (//distro-packages.list//) and sometimes additional files. This saves you the effort of saving the configuration files and provides a quick way of switching between them. of  A list of flavors available on the SliTaz servers can be downloaded and updated with Tazlito:+
  
   # tazlito list-flavors   # tazlito list-flavors
Line 60: Line 54:
 The list of flavors will be automatically displayed, showing the size of the LiveCD and a brief description. To use a flavor, use the get-flavor command to download the flavor file, automatically extract the package list and description in the current directory, and put additional files in the ///home/slitaz/distro/addfiles// directory: The list of flavors will be automatically displayed, showing the size of the LiveCD and a brief description. To use a flavor, use the get-flavor command to download the flavor file, automatically extract the package list and description in the current directory, and put additional files in the ///home/slitaz/distro/addfiles// directory:
  
-   # tazlito get-flavor name+   # tazlito get-flavor flavor_name
  
 \\ \\
Line 75: Line 69:
 \\ \\
  
-===== Part II: Generating the Distribution =====+====== Part II: Generating the Distribution  ======
  
 <note important>When generating a distro, there are some essential //base-system// packages that must be included. The dependency information in each package will take effect so these will be automatically included, even if they are not specified in the package list.</note> <note important>When generating a distro, there are some essential //base-system// packages that must be included. The dependency information in each package will take effect so these will be automatically included, even if they are not specified in the package list.</note>
Line 91: Line 85:
 \\ \\
  
-=== Cleaning & Re-Generating === +==== Cleaning & Re-Generating ====
 As you have generated a LiveCD, you need to clean-up so another can be generated. Removing the resulting ISO image, cleaning the generated distro tree (but not your additional files!) can be done through the //clean-distro// option: As you have generated a LiveCD, you need to clean-up so another can be generated. Removing the resulting ISO image, cleaning the generated distro tree (but not your additional files!) can be done through the //clean-distro// option:
  
Line 111: Line 104:
 \\ \\
  
-=== The 'Hacker' User ===+==== Hacking your customized SliTaz ISO ==== 
 +//See also [[en:handbook:hacklivecd]]// \\
  
-If you want to have a hacker user account, we must decompress the root file-system, add the account, then re-compress the root file-system. The first two stages can be executed as one command, the last stage another:+If you want to modify the splash screen, boot loader, configuration files, GRUB itself, ... you need to "hack" the iso you made using your flavor file using a "hacker user account". Note that you can also update your flavor-file with these extra modifications you made at the boot loader, splash screen, ... by means of the "tazlito iso2flavor <your-ISO_image> <your_flavor>" command. 
 + 
 +To make a hacker user account, we must decompress the root file-system, add the account, then re-compress the root file-system. The first two stages can be executed as one command, the last stage another:
  
    # tazlito addhacker    # tazlito addhacker
Line 121: Line 117:
  
 \\ \\
 +
 +===== Adding the final changes =====
 +//See also [[en:guides:persistence_splash]]// \\
 +
 +As mentioned above, you can add some last changes (that require modification from inside slitaz; like changing appearance, modifying the taskbar, ...) by simply making an additional rootfs file with a usb stick made with the iso of the slitaz version you just made (using the # tazusb writefs lzma command), and then adding it to the extracted iso (using the [[en:handbook:hacklivecd|hacker account]]). You can probably also reinclude these changes finally into your flavor file by means of the # tazlito extract-iso <your-ISO_image> <destination> command, combined with the tazlito pack-flavor <flavor_name> command. These 2 commands replace the old "tazlito iso2flavor" command (which can't be used any more).
 +
 +It should be noted that using this technique, you can probably delete packages too (see [[http://doc.slitaz.org/en:guides:manyinone|the manual on making many-in-one flavors]]). However, you best avoid this method however since the files are then probably still in the flavor/iso and the flavor/iso is hence larger than what it needs to be. The files/applications will simply not be used. 
  
 ===== Including Additional Files ===== ===== Including Additional Files =====
 
en/handbook/genlivecd.1282664491.txt.gz · Last modified: by linea