README
README.md
1# Xsnow: let it snow on your desktop
2## General
3
4Xsnow is derived from Rick Jansen's [xsnow-1.42](https://janswaal.home.xs4all.nl/Xsnow/).
5It now runs in many desktop environments: Gnome, KDE, FVWM, etc.
6
7Find [here](https://ratrabbit.nl/ratrabbit/xsnow/index.html) more information
8about this release.
9
10## Compilation and installation
11
12The file `dependencies` lists the dependencies. These should be
13installed before compiling xsnow.
14
15 tar xf xsnow-<version>.tar.gz
16 cd xsnow-<version>
17 ./configure
18 make
19 sudo make install
20
21Xsnow will be installed in /usr/local/games as `xsnow`.
22
23For users of debian distro's: you can download the appropriate
24.deb file and install with:
25
26 sudo apt install ./xsnow_<version>_<arch>.deb
27
28Raspberry pi - Raspian users: choose the .deb with arch=armhf (32 bit) or arch=arm64 (64 bit).
29
30If the above recipes do not work, you can try and run the
31script 'simplemake.sh':
32
33 ./simplemake.sh
34
35If problems persist, you can adapt simplemake.sh.
36
37## Self replication
38
39When not disabled in `./configure`, xsnow will be build as a self-replicating
40program, self-replicating activated by the flag `-selfrep`.
41
42To create a tar ball:
43
44 xsnow -selfrep > xsnow.tar.gz
45
46To create the source ball directly:
47
48 xsnow -selfrep | tar zxf -
49
50If you changed something, run `./configure` or `make dist` to refresh the tar ball,
51otherwise `xsnow -selfrep` will create the old version of the source.
52
53
54Have fun!
55
56
57
58