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 ## Installing extra media, including Trisquel 11 source code
  52
  53 This command also updates the Web page that shows up on boot.
  54
  55     sudo ./install-extras.sh trisquel_11.0_sources.tar /dev/sdX
  56
  57 ## Notes about video files and free space
  58
  59 You may wish to transcode the downloaded videos to save space on the member
  60 card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.
  61
  62     ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm
  63
  64     # check to make sure that the video quality is okay
  65     mplayer foo_smaller.webm
  66
  67     mv foo_smaller.webm foo.webm
  68
  69 Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
  70
  71     cd /mnt/fsf/GNUAV/
  72     sha256sum ./ > ../checksums.sha256
  73     mv ../checksums.sha256 .
  74