rofi/INSTALL.md

123 lines
1.5 KiB
Markdown
Raw Normal View History

2014-07-27 10:46:00 +00:00
# Installation guide
2014-07-27 07:54:10 +00:00
## DEPENDENCY
### For building:
2014-07-27 10:46:00 +00:00
* C compiler that supports the c99 standard. (gcc or clang)
2014-07-27 07:54:10 +00:00
* make
* autoconf
* automake
2015-01-05 21:35:42 +00:00
* Dev packages of the external libraries
2014-07-27 07:54:10 +00:00
### External libraries
* libxinerama
* libxft
* libpango
2014-07-27 07:54:10 +00:00
* libx11
2015-01-05 21:35:42 +00:00
2014-07-27 07:54:10 +00:00
### Optional:
* For i3 support, you need at least i3 version 4.5 or up.
2014-08-28 19:27:04 +00:00
Make sure that 'i3/ipc.h' is included. If it fails please check
config.log.
2014-07-21 14:41:31 +00:00
2014-07-27 10:46:00 +00:00
## Install from a release
2014-07-21 14:41:31 +00:00
Check dependencies and configure build system:
2014-07-27 07:54:10 +00:00
```
./configure
```
2014-07-21 14:41:31 +00:00
Build Rofi:
2014-07-27 07:54:10 +00:00
```
make
```
2014-07-21 14:41:31 +00:00
The actual install, execute as root (if needed):
2014-07-27 07:54:10 +00:00
```
make install
```
2014-07-21 14:41:31 +00:00
2014-07-27 10:46:00 +00:00
## Install a checkout from git
2014-07-21 14:41:31 +00:00
Generate build system:
2014-07-27 07:54:10 +00:00
```
autoreconf -i
```
2014-07-21 14:41:31 +00:00
Create a build directory:
2014-07-27 07:54:10 +00:00
```
mkdir build
```
2014-07-21 14:41:31 +00:00
2015-01-28 11:36:23 +00:00
Enter build directory:
```
cd build
```
2014-07-21 14:41:31 +00:00
Check dependencies and configure build system:
2014-07-27 07:54:10 +00:00
```
../configure
```
2014-07-21 14:41:31 +00:00
Build rofi:
2014-07-27 07:54:10 +00:00
```
make
```
2014-07-21 14:41:31 +00:00
The actual install, execute as root (if needed):
2014-07-27 07:54:10 +00:00
```
make install
```
2014-07-21 14:41:31 +00:00
2014-07-27 10:46:00 +00:00
## Options for configure
2014-07-21 14:41:31 +00:00
When you run the configure step there are several you can configure. (To see the full list type
`./configure --help` ).
The most useful one to set the installation prefix:
2014-07-27 07:54:10 +00:00
```
./configure --prefix=<installation path>
```
2014-07-21 14:41:31 +00:00
f.e.
2014-07-27 07:54:10 +00:00
```
./configure --prefix=/usr/
```
2014-07-21 14:41:31 +00:00
2014-07-27 10:46:00 +00:00
### Install locally
2014-07-21 14:41:31 +00:00
or to install locally:
2014-07-27 07:54:10 +00:00
```
./configure --prefix=${HOME}/.local/
```
2014-07-21 14:41:31 +00:00
2014-07-27 10:46:00 +00:00
### I3 workaround
If i3 is installed in a non-standard prefix, point it to the right location using:
```
CFLAGS="-I/weird/i3/path/include/" ../configure
CFLAGS="-I/weird/i3/path/include/" make
```