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