Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Installation instructions are unclear #268

Open
ventsyv opened this issue Jul 15, 2023 · 1 comment
Open

Installation instructions are unclear #268

ventsyv opened this issue Jul 15, 2023 · 1 comment

Comments

@ventsyv
Copy link

ventsyv commented Jul 15, 2023

I've been having a lot of issues trying to get Hyprland to run on Ubuntu 22.04, most due to what I consider poor documentation.

  1. Under Installation / Packages / Ubuntu 23 one would expect instruction how to install Hyprland on Ubuntu, instead the instructions are only for installing the build dependencies. This is very confusing. I suggest removing the Ubuntu section, or simply stating that there are no packages available. The installation of the build dependencies should be moved to the "Manual Build" section
  2. The instruction in the "Manual (Releases, Linux-only)" section are insufficient for Ubuntu 22. I had to install hwdata xutils-dev libtool xcb-proto packages, and build libdisplay-info, libliftoff, and libliftoff from source. This is after installing the build dependencies.
    Here is a quick script I put together that can be added to the documentation:
#!/usr/bin/env bash

cp Hyprland /usr/bin/
cp hyprctl /usr/bin/

cp libwlroots.so.12032 /usr/lib/
cp example/hyprland.desktop /usr/share/wayland-sessions/

apt-get install hwdata xutils-dev libtool xcb-proto

#Build & Install libdisplay-info

wget https://gitlab.freedesktop.org/emersion/libdisplay-info/-/releases/0.1.1/downloads/libdisplay-info-0.1.1.tar.xz
tar -xvJf libdisplay-info-0.1.1.tar.xz

cd libdisplay-info-0.1.1/

mkdir build
cd    build

meson setup --prefix=/usr --buildtype=release
ninja
ninja install

#Build & install libliftoff

cd ../..
git clone https://gitlab.freedesktop.org/emersion/libliftoff.git
cd libliftoff

mkdir build
cd build

meson setup --prefix=/usr --buildtype=release
ninja
ninja install

#Build & install libxcb-errors

cd ../..
git clone https://gitlab.freedesktop.org/xorg/lib/libxcb-errors.git
cd libxcb-errors/
git submodule update --init
./autogen.sh
make install

echo "export LD_LIBRARY_PATH=/usr/local/lib:/usr/lib/x86_64-linux-gnu" >> /home/$SUDO_USER/.bashrc```

3. There are undocumented runtime dependencies on LIBINPUT_1.23 and GLIBCXX_3.4.31 in the  "Manual (Releases, Linux-only)" section. Either add instructions how to install gcc-12 and libinputs 1.23 or distribute them with the release.

4. While I'm on Ubuntu 22.04, I'm fairly certain the same issues will exist on Ubuntu 23.X - the build dependencies do not list any of the packages / libraries I had to build / install.
@vaxerski
Copy link
Member

ubuntu page is community-made and I accept any and all MRs that make sense to it. We do not offer support for anything other than arch and nix.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants