README.mdwn

   1 # README
   2
   3 ## Getting the base ISO
   4
   5 This script assumes that you are starting with the special ISO from the
   6 following URL. It already contains video files that the script in this repo
   7 will not try to download.
   8
   9 <https://cdbuilds.trisquel.org/fsf/trisquel_11.0-fsf_amd64.iso>
  10
  11 The corresponding source code tar can be found here:
  12
  13 <https://cdbuilds.trisquel.org/fsf/trisquel_11.0_sources.tar>
  14
  15 Feel free to test your download with the `trisquel_9.0-fsf_i686.iso.sha256`
  16 file in this repo:
  17
  18     sha2565sum -c trisquel_11.0-fsf_amd64.iso.sha256
  19     sha2565sum -c trisquel_11.0_sources.tar.sha256
  20
  21 If you don't have access to the FSF version of the Trisquel images, refer to
  22 the following script and files:
  23
  24 <https://gitlab.trisquel.org/trisquel/makeiso/-/blob/master/makeiso.sh>
  25 <https://gitlab.trisquel.org/trisquel/makeiso/-/tree/master/files/fsf/GNUAV>
  26
  27 ## Making a bootable USB drive
  28
  29 This should work on an external USB drive, ideally one that is 12 GB or greater
  30 in size, if you want to intsall all of the media files onto it. Note that using
  31 a loop device will probably not work, partly due to the way syslinux behaves
  32 with loop devices. If you get that working, feel free to submit a patch to
  33 <sysadmin@gnu.org>. : )
  34
  35 This script has been tested on GNU/Linux with syslinux version 6.04.
  36
  37 You should wipe at least the start of the drive you want to install onto. Note
  38 that this is a destructive operation, and if you choose the wrong drive, you
  39 will lose data. Replace the 'X' in /dev/sdX with the letter of the drive you
  40 want to install to:
  41
  42     lsblk
  43
  44     # if you want to wipe /dev/sdX
  45     dd if=/dev/zero of=/dev/sdX bs=4M count=25
  46
  47 Then run the script on the same drive:
  48
  49     sudo ./live-usb-loader.sh trisquel_11.0-fsf_amd64.iso /dev/sdX
  50
  51 If GRUB in LibreBoot doesn't recognize the USB isolinux menu, then Re-run the
  52 following commands for your USB device:
  53
  54     umount /dev/sdX*
  55     syslinux --directory /syslinux/ --install /dev/sdX1
  56     sudo dd if=/usr/lib/SYSLINUX/mbr.bin of=/dev/sdX
  57     parted /dev/sdX set 1 boot on
  58
  59 ## Installing extra media, including Trisquel 11 source code
  60
  61 This command also updates the Web page that shows up on boot.
  62
  63     sudo ./install-extras.sh trisquel_11.0_sources.tar /dev/sdX
  64
  65 ## Notes about video files and free space
  66
  67 You may wish to transcode the downloaded videos to save space on the member
  68 card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.
  69
  70     ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm
  71
  72     # check to make sure that the video quality is okay
  73     mplayer foo_smaller.webm
  74
  75     mv foo_smaller.webm foo.webm
  76
  77 Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
  78
  79     cd /mnt/fsf/GNUAV/
  80     sha256sum ./ > ../checksums.sha256
  81     mv ../checksums.sha256 .
  82