archcraft-os / Archcraft

Yet another minimal linux distribution, based on Arch Linux.

Homepage | Installation | Features | Screenshots | Wiki

Latest Blog Posts

• Things To Do After Installing Archcraft OS
• Build Archcraft ISO With Its Source
• Install Archcraft On UEFI System (With Encryption)
• Install Archcraft On BIOS System (With Encryption)
• Create A Bootable USB With Archcraft
• Boot Archcraft ISO With GRUB2 Bootloader

Highlights

• ABIF : Arch Base Installation Framework - A Generic Offline Installer
• GRUB2 : GRand Unified Bootloader - A multi-boot loader
• Plymouth : The flicker-free graphical boot screen
• Xorg : The most popular display server
• LXDM : A lightweight display manager (login screen)
• Openbox : A lightweight, powerful, and highly configurable stacking window manager
• Bspwm : A tiling window manager, supports multiple monitors
• Compton : A standalone compositor for Xorg, suitable for WMs
• Polybar : A fast and easy-to-use tool for creating status bars
• Rofi : Application launcher, menus & applets
• Dunst : A lightweight notification daemon
• Network Manager : Manage network connection
• Thunar & PCmanFM : File managers for each window manager
• Geany & Leafpad : A lightweight IDE & text editor
• Yay : AUR (Arch User Repository) helper
• Styles scripts : Various scripts to change style for each WM
• Font Changer : An individual & a global font changer
• Wallpaper Generator : Generates various kinds of wallpapers and applies them
• Shell : Zsh with OMZ framework
• CLI Programs : Vim, ranger, htop, bashtop, bmon, ncmpcpp & more

Get The ISO

1. Download - You can either download already generated ISO file, or...

2. Build ISO - If you're already using archlinux & want to build the iso, maybe with your config then...

Check list

• [ ] archiso version : 47.1-1
• [ ] At least 10GB of free space
• [ ] Arch Linux 64-bit only
• [ ] Clear pacman cache; sudo pacman -Scc
• [ ] Configure everything as root
• [ ] Disable auto updates

• Open terminal and clone the archcraft repository.

git clone --depth=1 https://github.com/archcraft-os/archcraft.git

• Change to the archcraft directory & run setup.sh.

cd archcraft
chmod +x setup.sh
./setup.sh

• Now, Change to the iso directory & run build.sh as root.

cd iso
sudo su
./build.sh -v

• If everything goes well, you'll have the ISO in iso/out directory.
  

If you want to Rebuild the ISO, remove work & out dirs inside iso directory first. then run ./build.sh -v as root. You don't need to run setup.sh again, it's a one time process only.

Boot The ISO

1. Using GRUB - If you're already using a linux distro with grub, then you can add following entry in your grub.cfg file, Replace X with your partition number, and /path/to/archcraft.iso with ISO path.

menuentry "Archcraft OS Amd_x86_x64" --class archcraft {
    set root='(hd0,X)'
    set isofile="/path/to/archcraft.iso"
    set dri="free"
    search --no-floppy -f --set=root $isofile
    probe -u $root --set=abc
    set pqr="/dev/disk/by-uuid/$abc"
    loopback loop $isofile
    linux  (loop)/arch/boot/x86_64/vmlinuz-linux img_dev=$pqr img_loop=$isofile driver=$dri quiet splash vt.global_cursor_default=0 loglevel=2 rd.systemd.show_status=false rd.udev.log-priority=3 sysrq_always_enabled=1 cow_spacesize=2G
    initrd  (loop)/arch/boot/intel-ucode.img (loop)/arch/boot/amd-ucode.img (loop)/arch/boot/x86_64/archiso.img
}

2. Using dd - Alternatively, you can use dd command to make a bootable USB_Drive/SDcard, Just open the terminal and...

sudo su
dd bs=4M if=/path/to/archcraft.iso of=/dev/sdX status=progress oflag=sync

3. Using Etcher - If you use Windows, or maybe linux but afraid of dd, then you can use Etcher to make a bootable USB/SDcard.

FYI

• Default username and password is liveuser.
• After installing Archcraft, run sudo pacman -Syy to sync pacman database.
• Important - I've tested Archcraft on two laptops, with intel pantium & i3 CPUs. Obviously ISO have intel-video drivers, if you have nvidia or something, edit packages.x86_64 and uncomment the driver package according to your GPU, or WM/DE might freeze on startup (Blank/Gray screen after login).
• If polybar is not showing some icons properly, run ~/.config/polybar/fix_modules.sh to fix Battery & Network Modules.
• If grub is not showing other installed OSs, please run sudo grub-mkconfig -o /boot/grub/grub.cfg to regenerate grub config file on first boot into Archcraft OS.
• Update the lockscreen according to your screen resolution with betterlockscreen -u /usr/share/backgrounds/wal_10.jpg if it's messed up.