update docs about double installation of syslinux
[fsf-member-card-builder.git] / README.mdwn
... / ...
CommitLineData
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<https://cdbuilds.trisquel.org/fsf/trisquel_11.0-fsf_amd64.iso>
10
11The corresponding source code tar can be found here:
12
13<https://cdbuilds.trisquel.org/fsf/trisquel_11.0_sources.tar>
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_11.0-fsf_amd64.iso.sha256
19 sha2565sum -c trisquel_11.0_sources.tar.sha256
20
21If you don't have access to the FSF version of the Trisquel images, refer to
22the following script and files:
23
24<https://gitlab.trisquel.org/trisquel/makeiso/-/blob/master/makeiso.sh>
25<https://gitlab.trisquel.org/trisquel/makeiso/-/tree/master/files/fsf/GNUAV>
26
27## Making a bootable USB drive
28
29This should work on an external USB drive, ideally one that is 12 GB or greater
30in size, if you want to intsall all of the media files onto it. Note that using
31a loop device will probably not work, partly due to the way syslinux behaves
32with loop devices. If you get that working, feel free to submit a patch to
33<sysadmin@gnu.org>. : )
34
35This script has been tested on GNU/Linux with syslinux version 6.04.
36
37You should wipe at least the start of the drive you want to install onto. Note
38that this is a destructive operation, and if you choose the wrong drive, you
39will lose data. Replace the 'X' in /dev/sdX with the letter of the drive you
40want to install to:
41
42 lsblk
43
44 # if you want to wipe /dev/sdX
45 dd if=/dev/zero of=/dev/sdX bs=4M count=25
46
47Then run the script on the same drive:
48
49 sudo ./live-usb-loader.sh trisquel_11.0-fsf_amd64.iso /dev/sdX
50
51## Installing extra media, including Trisquel 11 source code
52
53This command also updates the Web page that shows up on boot.
54
55 sudo ./install-extras.sh trisquel_11.0_sources.tar /dev/sdX
56
57## Notes about video files and free space
58
59You may wish to transcode the downloaded videos to save space on the member
60card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.
61
62 ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm
63
64 # check to make sure that the video quality is okay
65 mplayer foo_smaller.webm
66
67 mv foo_smaller.webm foo.webm
68
69Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
70
71 cd /mnt/fsf/GNUAV/
72 sha256sum ./ > ../checksums.sha256
73 mv ../checksums.sha256 .
74