mirror of https://github.com/davatorium/rofi.git synced 2024-11-11 13:50:48 -05:00

* input method draft

* restoring relese event

* using unused macro, removing debug code, handling disconnection

* review fixes, new update_im_window_pos method

* initializing variables correctly

* initializing im pos queue correctly

* ime window positioning

* add widget_get_y_pos() position

* [Build] Update makefile with imdkit

* [CI] Add imdkit as dependency.

* [XCB] rofi_view_paste don't throw warning, print debug.

* [XCB] rofi_view_paste lower 'failed to convert selection'

* [Build] Add minimum version check to imdkit

* new macro XCB_IMDKIT_1_0_3_LOWER

* [Build] Try to support old version of imdkit in meson/makefile.

* [Build] Fix typo in meson.build

* [XIM] Don't set use compound/set use utf8 when on old version.

* [Build] Allow building without imdkit.

* [Doc] Add imdkit to dependency list.

Co-authored-by: Dave Davenport <qball@gmpclient.org>

2022-11-08 19:18:45 +01:00

5.1 KiB

Raw Blame History

Installation guide

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. You can also use Meson as an alternative.

DEPENDENCY

For building:

C compiler that supports the c99 standard. (gcc or clang)
make
autoconf
automake (1.11.3 or up)
pkg-config
flex 2.5.39 or higher
bison
check (Can be disabled using the --disable-check configure flag) check is used for build-time tests and does not affect functionality.
Developer packages of the external libraries
glib-compile-resources

External libraries

libpango >= 1.50
libpangocairo
libcairo
libcairo-xcb
libglib2.0 >= 2.68
- gmodule-2.0
- gio-unix-2.0
libgdk-pixbuf-2.0
libstartup-notification-1.0
libxkbcommon >= 0.4.1
libxkbcommon-x11
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)
xcb-util-cursor
xcb-imdkit (optional, 1.0.3 or up preferred)

On debian based systems, the developer packages are in the form of: <package>-dev on rpm based <package>-devel.

Install from a release

Autotools

Create a build directory and enter it:

mkdir build && cd build

Check dependencies and configure build system:

../configure

Build Rofi:

make

The actual install, execute as root (if needed):

make install

The default installation prefix is: /usr/local/ use ./configure --prefix={prefix} to install into another location.

Meson

Check dependencies and configure build system:

meson setup build

Build Rofi:

ninja -C build

The actual install, execute as root (if needed):

ninja -C build install

The default installation prefix is: /usr/local/ use meson setup build --prefix={prefix} to install into another location.

Install a checkout from git

The GitHub Pages version of these directions may be out of date. Please use INSTALL.md from the online repo or your local repository.

If you don't have a checkout:

git clone --recursive https://github.com/DaveDavenport/rofi
cd rofi/

If you already have a checkout:

cd rofi/
git pull
git submodule update --init

For Autotools you have an extra step, to generate build system:

autoreconf -i

From this point, use the same steps you use for a release.

Options for configure

When you run the configure step there are several options you can configure. For Autotools, you can see the full list with ./configure --help. For Meson, before the initial setup, you can see rofi options in meson_options.txt and Meson options with meson setup --help. After the initial setup, use meson configure build.

The most useful one to set the installation prefix:

# Autotools
../configure --prefix=<installation path>

# Meson
meson setup build --prefix <installation path>

f.e.

# Autotools
../configure --prefix=/usr/

# Meson
meson setup build --prefix /usr

Install locally

or to install locally:

# Autotools
../configure --prefix=${HOME}/.local/

# Meson
meson setup build --prefix ${HOME}/.local

Options for make

When you run make you can tweak the build process a little.

Verbose output

Show the commands called:

# Autotools
make V=1

# Meson
ninja -C build -v

Debug build

Compile with debug symbols and no optimization, this is useful for making backtraces:

# Autotools
make CFLAGS="-O0 -g3" clean rofi

# Meson
meson configure build --debug
ninja -C build

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.

# Autotools
gdb rofi core

# Meson (because it uses a separate build directory)
gdb build/rofi core

Where the core file is located and what its exact name is different on each distributions. Please consult the relevant documentation.

Install distribution

Debian or Ubuntu

apt install rofi

Fedora

dnf install rofi

ArchLinux

pacman -S rofi

Gentoo

An ebuild is available, x11-misc/rofi. It's up to date, but you may need to enable ~arch to get the latest release:

echo 'x11-misc/rofi ~amd64' >> /etc/portage/package.accept_keywords

for amd64 or:

echo 'x11-misc/rofi ~x86' >> /etc/portage/package.accept_keywords

for i386.

To install it, simply issue emerge rofi.

openSUSE

On both openSUSE Leap and openSUSE Tumbleweed rofi can be installed using:

sudo zypper install rofi

FreeBSD

sudo pkg install rofi

macOS

On macOS rofi can be installed via MacPorts:

sudo port install rofi

5.1 KiB Raw Blame History