sleep before unmounting, to avoid race condition
[fsf-member-card-builder.git] / README.mdwn
CommitLineData
be702161
AE
1# README
2
3## Getting the base ISO
4
5This script assumes that you are starting with the special ISO from the
6following URL. It already contains video files that the script in this repo
7will not try to download.
8
9<http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0-fsf_i686.iso>
10
11The corresponding source code ISO can be found here:
12
13<http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0fsf_sources.iso>
14
15Feel free to test your download with the `trisquel_9.0-fsf_i686.iso.sha256`
16file 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
23This should work on an external USB drive, ideally one that is 12 GB or greater
24in size. Note that using a loop device will probably not work, partly due to
25the way syslinux behaves with loop devices. If you get that working, feel free
26to submit a patch to <sysadmin@gnu.org>. : )
27
28You'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
33Check 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
214a770e
AE
44This command also updates the Web page that shows up on boot.
45
be702161
AE
46 sudo ./install-extras.sh trisquel_9.0fsf_sources.iso /dev/sdb
47
48## Notes about video files and free space
49
50You may wish to transcode the downloaded videos to save space on the member
51card, 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
60Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
61
62 cd /mnt/fsf/GNUAV/
63 sha256sum ./ > ../checksums.sha256
64 mv ../checksums.sha256 .
65