mirror of
https://github.com/davatorium/rofi.git
synced 2024-11-25 13:55:34 -05:00
158 lines
2.2 KiB
Markdown
158 lines
2.2 KiB
Markdown
# Installation guide
|
|
|
|
## DEPENDENCY
|
|
|
|
### For building:
|
|
|
|
* C compiler that supports the c99 standard. (gcc or clang)
|
|
* make
|
|
* autoconf
|
|
* automake (1.11.3 or up)
|
|
* pkg-config
|
|
* Developer packages of the external libraries
|
|
|
|
### External libraries
|
|
|
|
* libxinerama
|
|
* libxft2
|
|
* libpango
|
|
* libpangoxft
|
|
* libglib2.0
|
|
* libx11
|
|
|
|
On debian based systems, the developer packages are in the form of: `<package>-dev` on rpm based
|
|
'<package>-devel'.
|
|
|
|
|
|
### Optional:
|
|
|
|
* For i3 support, you need at least i3 version 4.5 or up.
|
|
Make sure that 'i3/ipc.h' is included. If it fails please check
|
|
config.log.
|
|
|
|
|
|
|
|
## Install from a release
|
|
|
|
Check dependencies and configure build system:
|
|
|
|
```
|
|
./configure
|
|
```
|
|
|
|
Build Rofi:
|
|
|
|
```
|
|
make
|
|
```
|
|
|
|
The actual install, execute as root (if needed):
|
|
|
|
```
|
|
make install
|
|
```
|
|
|
|
|
|
## Install a checkout from git
|
|
|
|
Generate build system:
|
|
|
|
```
|
|
autoreconf -i
|
|
```
|
|
|
|
Create a build directory:
|
|
|
|
```
|
|
mkdir build
|
|
```
|
|
|
|
Enter build directory:
|
|
|
|
```
|
|
cd build
|
|
```
|
|
|
|
Check dependencies and configure build system:
|
|
|
|
```
|
|
../configure
|
|
```
|
|
|
|
Build rofi:
|
|
|
|
```
|
|
make
|
|
```
|
|
|
|
The actual install, execute as root (if needed):
|
|
|
|
```
|
|
make install
|
|
```
|
|
|
|
|
|
## Options for configure
|
|
|
|
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:
|
|
|
|
```
|
|
./configure --prefix=<installation path>
|
|
```
|
|
|
|
f.e.
|
|
|
|
```
|
|
./configure --prefix=/usr/
|
|
```
|
|
|
|
### Install locally
|
|
|
|
or to install locally:
|
|
|
|
```
|
|
./configure --prefix=${HOME}/.local/
|
|
```
|
|
|
|
### 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
|
|
```
|
|
|
|
## Options for make
|
|
|
|
When you run make you can tweak the build process a little.
|
|
|
|
### Verbose output
|
|
|
|
Show the commands called:
|
|
|
|
```
|
|
make V=1
|
|
```
|
|
|
|
### Debug build
|
|
|
|
Compile with debug symbols and no optimization
|
|
|
|
```
|
|
make CFLAGS="-O0 -g3" clean rofi
|
|
```
|
|
|
|
### Get a backtrace
|
|
|
|
Getting a backtrace using GDB is not very handy. Because if rofi get stuck, it grabs keyboard and
|
|
mouse. So if it crashes in GDB you are stuck.
|
|
The best way to go is to enable core file. (ulimit -c unlimited in bash) then make rofi crash. You
|
|
can then load the core in GDB.
|
|
|
|
```
|
|
gdb rofi core
|
|
```
|