From fa9b26acaa4a8f955eb9a9b92af7345652966f89 Mon Sep 17 00:00:00 2001 From: tio Date: Thu, 16 Jun 2022 14:36:24 +0200 Subject: [PATCH] updated the instructions readme file --- README.md | 68 +++++++++---------------------------------------------- 1 file changed, 11 insertions(+), 57 deletions(-) diff --git a/README.md b/README.md index 0ba92f03..15d6ad90 100644 --- a/README.md +++ b/README.md @@ -2,80 +2,33 @@ Configuration to build latest TROMjaro ISO -**See adding packages to custom repo**: [Adding/Removing-Packages](https://gitlab.com/tromsite/tromjaro/iso-profiles/wikis/TROMjaro-Repository---Adding/Removing-Packages) ## Prerequisites -Install Manjaro Tools -To get started you need to the following meta-package: - +Install the following packages ``` -pamac install manjaro-tools-iso git +manjaro-tools-base-git +manjaro-tools-iso-git ``` Download the latest TROMjaro Profile: ``` -git clone https://gitlab.com/tromsite/tromjaro/iso-profiles.git ~/iso-profiles +git clone https://git.trom.tf/TROMjaro/iso-profiles-settings ``` +Choose where to clone/copy it. Let's name that `path`. -## Getting Started -The ISO profile for TROMjaro can now be found at: +# Build it -``` -~/iso-profiles/tromjaro/gnome -``` -Let's take a closer look at the gnome profile folder (marked above): +Before building it, we have to copy the `/etc/manjaro-tools/` folder to the `.config` folder in the Home directory. So it will look like `.config/manjaro-tools/` -``` -**desktop-overlay** -live-overlay -> ../../shared/manjaro/live-overlay -**Packages-Desktop** -Packages-Live -> ../../shared/Packages-Live -Packages-Mhwd -> ../../shared/Packages-Mhwd -Packages-Root -> ../../shared/Packages-Root -**profile.conf** -``` -- **desktop-overlay**: After every successful installation of your ISO the files and folders in here will get copied over. -- live-overlay: Similar to desktop-overlay. Files and folders in here will only get copied over to the LiveCD of your ISO. -- **Packages-Desktop**: This file contains packages for the ISO installation. All packages will also get installed on LiveCDs. -- Packages-Live: This file contains packages, which will only get installed on the LiveCD. -- Packages-Mhwd: This file contains Mhwd packages important to all Manjaro installations and LiveCDs. -- Packages-Root: This file contains base packages important to all Manjaro installations and LiveCDs. -- **profile.conf** contains basic settings for your ISO installation and LiveCD. +In that folder we have the file `iso-profiles.conf`. Make sure you add this to the file, to basically tell the ISO Tools where to get the profile files from: `run_dir=path/iso-profiles/iso-profiles-settings` -As you have probably noticed, several are only symlinks to the shared ISO profile. It is good practice to never change files or folders in the shared ISO profile. If you ever want to change them, first copy them to your ISO profile folder and delete the symlink. +Replace `path` with the path where you have cloned our ISO Profile. -All folders and files specific to your ISO are in bold. You can change them to your liking. - -## Live boot hack - -First backup: -``` -mkdir ~/mysafespace && cp /etc/lsb-release ~/mysafespace/lsb-release -``` -Then copy the following: - -``` -sudo cp ~/iso-profiles/tromjaro/lsb-release /etc/lsb-release -``` -**IMPORTANT** - -When build is complete please ensure to restore your lsb-release file: -``` -sudo cp ~/mysafespace/lsb-release /etc/lsb-release -``` - -### Build your ISO - -Build TROMjaro with the following command: - -``` -buildiso -p gnome -``` -**Attention**: The build process needs at least 10 minutes to complete or much longer when you are using HDDs, slow CPUs, or large ISOs. +Lastly, open the terminal and do `buildiso -p xfce` When the build process finishes successfully, the ISO file and the package list will appear in this folder: @@ -83,6 +36,7 @@ When the build process finishes successfully, the ISO file and the package list /var/cache/manjaro-tools/iso/ ``` + ## Cleaning your hard drive After a successful or failed build, you can get rid of most data (the "raw" ISO with all downloaded packages) by deleting this folder: