fix tar command

[fsf-member-card-builder.git] / README.mdwn

# README

## Getting the base ISO

This script assumes that you are starting with the special ISO from the
following URL. It already contains video files that the script in this repo
will not try to download.

<https://cdbuilds.trisquel.org/fsf/trisquel_11.0-fsf_amd64.iso>

The corresponding source code tar can be found here:

<https://cdbuilds.trisquel.org/fsf/trisquel_11.0_sources.tar>

Feel free to test your download with the `trisquel_9.0-fsf_i686.iso.sha256`
file in this repo:

    sha2565sum -c trisquel_11.0-fsf_amd64.iso.sha256
    sha2565sum -c trisquel_11.0_sources.tar.sha256

If you don't have access to the FSF version of the Trisquel images, refer to
the following script and files:

<https://gitlab.trisquel.org/trisquel/makeiso/-/blob/master/makeiso.sh>
<https://gitlab.trisquel.org/trisquel/makeiso/-/tree/master/files/fsf/GNUAV>

## Making a bootable USB drive

This should work on an external USB drive, ideally one that is 12 GB or greater
in size, if you want to intsall all of the media files onto it. Note that using
a loop device will probably not work, partly due to the way syslinux behaves
with loop devices. If you get that working, feel free to submit a patch to
<sysadmin@gnu.org>. : )

You'll need to download and install old versions of syslinux:

* <https://oldarchive.trisquel.info/trisquel/pool/main/s/syslinux/syslinux-common_4.05+dfsg-6+deb8u1_all.deb>
* <https://oldarchive.trisquel.info/trisquel/pool/main/s/syslinux/syslinux_4.05+dfsg-6+deb8u1_amd64.deb>

Check files, install them, and run the script:

    sha256sum -c syslinux.deb.sha256

    dpkg -i syslinux-common_4.05+dfsg-6+deb8u1_all.deb
    dpkg -i syslinux_4.05+dfsg-6+deb8u1_amd64.deb

    sudo ./live-usb-loader.sh trisquel_11.0-fsf_amd64.iso /dev/sdb

## Installing extra media, including Trisquel 9 source code

This command also updates the Web page that shows up on boot.

    sudo ./install-extras.sh trisquel_11.0_sources.tar /dev/sdb

## Notes about video files and free space

You may wish to transcode the downloaded videos to save space on the member
card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.

    ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm

    # check to make sure that the video quality is okay
    mplayer foo_smaller.webm

    mv foo_smaller.webm foo.webm

Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:

    cd /mnt/fsf/GNUAV/
    sha256sum ./ > ../checksums.sha256
    mv ../checksums.sha256 .