f6f6bcbb50abbf2de2e6d1c6b063d71238a88745
[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 sudo ./install-extras.sh trisquel_9.0fsf_sources.iso /dev/sdb
45
46 ## Notes about video files and free space
47
48 You may wish to transcode the downloaded videos to save space on the member
49 card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.
50
51 ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm
52
53 # check to make sure that the video quality is okay
54 mplayer foo_smaller.webm
55
56 mv foo_smaller.webm foo.webm
57
58 Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
59
60 cd /mnt/fsf/GNUAV/
61 sha256sum ./ > ../checksums.sha256
62 mv ../checksums.sha256 .
63