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 You'll need to download and install old versions of syslinux:
  36
  37 * <https://oldarchive.trisquel.info/trisquel/pool/main/s/syslinux/syslinux-common_4.05+dfsg-6+deb8u1_all.deb>
  38 * <https://oldarchive.trisquel.info/trisquel/pool/main/s/syslinux/syslinux_4.05+dfsg-6+deb8u1_amd64.deb>
  39
  40 Check files, install them, and run the script:
  41
  42     sha256sum -c syslinux.deb.sha256
  43
  44     dpkg -i syslinux-common_4.05+dfsg-6+deb8u1_all.deb
  45     dpkg -i syslinux_4.05+dfsg-6+deb8u1_amd64.deb
  46
  47     sudo ./live-usb-loader.sh trisquel_11.0-fsf_amd64.iso /dev/sdb
  48
  49 ## Installing extra media, including Trisquel 9 source code
  50
  51 This command also updates the Web page that shows up on boot.
  52
  53     sudo ./install-extras.sh trisquel_11.0_sources.tar /dev/sdb
  54
  55 ## Notes about video files and free space
  56
  57 You may wish to transcode the downloaded videos to save space on the member
  58 card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.
  59
  60     ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm
  61
  62     # check to make sure that the video quality is okay
  63     mplayer foo_smaller.webm
  64
  65     mv foo_smaller.webm foo.webm
  66
  67 Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
  68
  69     cd /mnt/fsf/GNUAV/
  70     sha256sum ./ > ../checksums.sha256
  71     mv ../checksums.sha256 .
  72