added readme
[lxqt-slackware.git] / README.md
CommitLineData
b4309abf 1# LXQT on Slackware
2
3A collection of scripts to let you build [LXQT](https://github.com/lxqt/lxqt/) 0.15.0 on Slackware
4
5## Getting Started
6
7If you want to build lxqt on Slackware these scripts will help you. I tried to make every step trivial but I can't be sure these instructions will work on every system. If you want to build different versions of LXQT those script will probably not work unless you modify them.
8
9### Prerequisites
10
11In order to build LXQT on Slackware you'll need a few packages from [SlackBuilds.org](https://slackbuilds.org/), here's the list:
12
13* openbox - [SBo](https://slackbuilds.org/repository/14.2/desktop/openbox/)
14* imlib2 (optional for openbox) - [SBo](https://slackbuilds.org/repository/14.2/libraries/imlib2/)
15* muParser - [SBo](https://slackbuilds.org/repository/14.2/libraries/muParser/)
16* libstatgrab - [SBo](https://slackbuilds.org/repository/14.2/libraries/libstatgrab/)
17* libconfig - [SBo](https://slackbuilds.org/repository/14.2/libraries/libconfig/)
18
19Then I used AlienBob's ktown repository and installed his KDE5 packages, I've used the PAM enabled packages because I recently converted my slackware64-current to PAM, so if you decide to go the non-PAM way, I have no idea if you'll be able to build without the need for patches.
20The latest set of packages for KDE5 from AlienBob are here --> [ktown](https://alien.slackbook.org/ktown/current/)
21
22### Preparation
23
24Before we get to start building we need to do a few things:
25
26* Check prerequisite packages to ensure that we have all dependancies:
27```
28sh CHECK_PREREQ.sh
29```
30 * after running this script we'll have a log of all the installed dependancies as well as hints on where to find those packages we are missing.
31 * a little notice regarding gtk+2 and gtk+3, even if those 2 packages are installed, my script doesn't see them, I think it has something to do with the way regex works and the fact that there's a + in the name, but I didn't investigate much. Bottom line, if you have them installed you're good to go!
32* Download the source tree, this operation will also give us the version numbers for every package
33```
34sh DOWNLOAD.sh
35```
36 * this script will generate a versioning file containing all the version numbers for the packages.
37
38### Building and Installing
39
40Now we have everything we need, with a little luck we don't need to do much except:
41```
42sh build_all.sh
43```
44and after a while we should see our packages inside the packages directory.
45
46## Tested on
47
48I tested this bunch of scripts on a fresh install of slackware64-current updated on 24/04/2020, the system is running inside a chroot that I reinstall fresh everytime I have to build something.
49If your system is not so clean YMMV as you can imagine.
50
51## Contributing
52
53Feel free to contribute however you feel like.
54
55## Authors
56
57* **Danilo 'danix' Macrì** - *owner* - [danix.xyz](https://danix.xyz)
58
59## License
60
61This project is licensed under the GPLv3 - see the [LICENSE.md](LICENSE.md) file for details
62
63## Acknowledgments
64
65* Huge thans to [AlienBob](https://alien.slackbook.org/blog/) whose original lxqt slackbuilds I've used and modified to write this set
66* Of course all the people behind [LXQT](https://github.com/lxqt/lxqt/), what they do is amazing and I can't thank them enough.