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