6b9951e399236c3bec2dd9003be31e162189edc7
[fsf-member-card-builder.git] / 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 <http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0-fsf_i686.iso>
10
11 The corresponding source code ISO can be found here:
12
13 <http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0fsf_sources.iso>
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_9.0-fsf_i686.iso.sha256
19     sha2565sum -c trisquel_9.0fsf_sources.iso.sha256
20
21 ## Making a bootable USB drive
22
23 This should work on an external USB drive, ideally one that is 12 GB or greater
24 in size. Note that using a loop device will probably not work, partly due to
25 the way syslinux behaves with loop devices. If you get that working, feel free
26 to submit a patch to <sysadmin@gnu.org>. : )
27
28 You'll need to download and install old versions of syslinux:
29
30 * <https://mirror.fsf.org/trisquel/pool/main/s/syslinux/syslinux-common_4.05+dfsg-6+deb8u1_all.deb>
31 * <https://mirror.fsf.org/trisquel/pool/main/s/syslinux/syslinux_4.05+dfsg-6+deb8u1_amd64.deb>
32
33 Check files, install them, and run the script:
34
35     sha256sum -c syslinux.deb.sha256
36
37     dpkg -i syslinux-common_4.05+dfsg-6+deb8u1_all.deb
38     dpkg -i syslinux_4.05+dfsg-6+deb8u1_amd64.deb
39
40     sudo ./live-usb-loader.sh trisquel_9.0-fsf_i686.iso /dev/sdb
41
42 ## Installing extra media, including Trisquel 9 source code
43
44 This command also updates the Web page that shows up on boot.
45
46     sudo ./install-extras.sh trisquel_9.0fsf_sources.iso /dev/sdb
47
48 ## Notes about video files and free space
49
50 You may wish to transcode the downloaded videos to save space on the member
51 card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.
52
53     ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm
54
55     # check to make sure that the video quality is okay
56     mplayer foo_smaller.webm
57
58     mv foo_smaller.webm foo.webm
59
60 Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
61
62     cd /mnt/fsf/GNUAV/
63     sha256sum ./ > ../checksums.sha256
64     mv ../checksums.sha256 .
65