rofi/INSTALL.md

202 lines
3.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
2017-03-24 08:44:08 +00:00
This guide explains how to install rofi using its build system and how you can make debug builds.
Rofi uses autotools (GNU Build system), for more information see
[here](https://www.gnu.org/software/automake/manual/html_node/Autotools-Introduction.html).
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 (1.11.3 or up)
* pkg-config
2017-04-04 15:54:04 +00:00
* flex 2.5.39 or higher
* bison
* Developer packages of the external libraries
2014-07-27 07:54:10 +00:00
### External libraries
* libpango
2015-10-25 10:11:42 +00:00
* libpangocairo
* libcairo
2016-03-05 10:38:41 +00:00
* libcairo-xcb
2015-12-01 21:35:05 +00:00
* libglib2.0 >= 2.40
2017-03-24 08:44:08 +00:00
* gmodule-2.0
* gio-unix-2.0
2015-09-13 15:29:50 +00:00
* libstartup-notification-1.0
2016-07-28 06:11:23 +00:00
* libxkbcommon >= 0.5.0
* libxkbcommon-x11
2016-08-31 08:01:49 +00:00
* libxcb (sometimes split, you need libxcb, libxcb-xkb and libxcb-randr libxcb-xinerama)
* xcb-util
* xcb-util-wm (sometimes split as libxcb-ewmh and libxcb-icccm)
2016-07-28 06:11:23 +00:00
* xcb-util-xrm [new module, can be found here](https://github.com/Airblader/xcb-util-xrm/)
2014-07-27 07:54:10 +00:00
On debian based systems, the developer packages are in the form of: `<package>-dev` on rpm based
`<package>-devel`.
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
2017-03-24 08:44:08 +00:00
The default installation prefix is: `/usr/local/` use `./configure --prefix={prefix}` to install into another location.
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
The GitHub Pages version of these directions may be out of date. Please use
[INSTALL.md from the online repo][master-install] or your local repository.
[master-install]: https://github.com/DaveDavenport/rofi/blob/master/INSTALL.md#install-a-checkout-from-git
2017-03-24 08:44:08 +00:00
Make a checkout:
```
git clone https://github.com/DaveDavenport/rofi
2017-03-24 08:45:52 +00:00
cd rofi/
2017-03-24 08:44:08 +00:00
```
2016-03-05 12:36:18 +00:00
Pull in dependencies
```
git submodule update --init
```
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
## 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
2017-03-24 08:44:08 +00:00
Compile with debug symbols and no optimization, this is useful for making backtraces:
```
make CFLAGS="-O0 -g3" clean rofi
```
2015-03-28 16:04:34 +00:00
### 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
```
2015-10-25 12:54:41 +00:00
2017-03-24 08:44:08 +00:00
> Where the core file is located and what its exact name is different on each distributions. Please consult the
> relevant documentation.
2015-10-25 12:54:41 +00:00
## Install distribution
### Debian or Ubuntu
```
2017-03-24 08:44:08 +00:00
apt install rofi
2015-10-25 12:54:41 +00:00
```
### Fedora
rofi from [russianfedora repository](http://ru.fedoracommunity.org/repository)
and also
[Yaroslav's COPR (Cool Other Package Repo)](https://copr.fedorainfracloud.org/coprs/yaroslav/i3desktop/)
2015-10-25 12:54:41 +00:00
2017-03-24 08:44:08 +00:00
### ArchLinux
```
pacman -S rofi
```