Giter VIP home page Giter VIP logo

debian-hyprland's Introduction

๐Ÿ’Œ JaKooLit's Debian/Ubuntu Hyprland Install Script ๐Ÿ’Œ

For Debian 13 Trixie and SID and Ubuntu 23.10 Mantic Minotaur or newer

GitHub Repo stars GitHub last commit GitHub repo size


โ™จ๏ธโ™จ๏ธโ™จ๏ธ ATTENTION โ™จ๏ธโ™จ๏ธโ™จ๏ธ 06 Dec 2023

  • Recent hyprland release v0.33.0, needed a newer libdrm and Debian dont have newer libdrm yet on their repo. That is why for now, the hyprland version to be installed with this script is v0.32.3

Important

install a backup tool like snapper or timeshift. and Backup your system before installing hyprland using this script. This script does NOT include uninstallation of packages

Note

Main reason why I have not included an uninstallation script is simple. Some packages maybe already installed on your system by default. If I create an uninstall script with packages that I have set to install, you may end up a unrecoverable system.

โš ๏ธ Pre-requisites and VERY Important!

  • Do not run this installer as sudo or as root
  • This Installer requires a user with a priviledge to install packages
  • Needs a Debian 13 Testing (Trixie) Branch as it needs a newer wayland packages! I have tried on Stable Debian 12 Bookworm in which, Hyprland wont build.
  • In theory, it should also work on Debian SID (unstable) but I have not tested yet.
  • edit your /etc/apt/sources.list and remove # on lines with deb-src to enable source packaging else will not install properly especially Hyprland
sudo nano /etc/apt/sources.list
  • delete # on the lines with 'deb-src'
  • ensure to allow to install non-free drivers especially for users with NVIDIA gpus. You can also install non-free drivers if required. Edit install-scripts/nvidia.sh and change the nvidia stuff's if required
  • If you have login Manager already like GDM (gnome login manager), I highly advice not to install SDDM. But if you decide to install SDDM, see here Issue 2 - SDDM

Important

UBUNTU USERS: You can use this installer. However, I have only tested on Ubuntu 23.10. Not sure if it works on older ubuntu as Hyprland needs an updated wayland libraries. For sure wont work in any Ubuntu LTS.

If you are using Gnome already, DO NOT install the SDDM. The GDM works file as well. For some reason, during installation, you will be asked which login manager you wanted to use. But during my test, nothing happened.

Ubuntu 23.10 dont have cliphist (used as clipboard manager) in their repo yet! And it is not set to build by default. If you want script to install for you, edit install-scripts/00-hypr-pks.sh line 15 remove the cliphist under hypr_package . then edit install.sh line 175 remove # in #execute_script "cliphist.sh"

Caution

For Ubuntu with NVIDIA GPU's, make sure to edit the install-scripts/nvidia.sh . Delete all packages in nvidia_pkg except libva-wayland2 and nvidia-vaapi-driver and uncomment/remove # before sudo ubuntu-drivers install. You also need to delete or simply just add # in the lines 37 and 38 echo "echo "## for nvidia" | sudo tee -a... and echo "deb http://deb.debian.org/debian........

Warning

If you have GDM already as log-in manager, DO NOT install SDDM You will encounter issues. See Issue 2 - SDDM

๐Ÿ“ท Hyprland-Dots-v2 Featuring Rofi

โ• Installed on Kali Linux ๐Ÿ˜ˆ

alt text

๐Ÿ“ท More updated Screenshots Here Link

๐Ÿ“ท Older Screenshots: v1Link & v2Link

โœจ Youtube presentation V1

โœจ Youtube presentation V2

โœจ A video walk through my dotfilesLink

โœจ A video walk through of My Hyprland-Dots v2Link

๐Ÿ’ฏ๐Ÿ’ฏ Check out Installation Video coverage by KSK royal (Ubuntu 23.10 + nvidia)

๐Ÿ’ฏ๐Ÿ’ฏ Check out Installation Video coverage by KSK royal (Kali Linux xfce + nvidia). He have details regarding installing timeshift and switching to sddm from lightdm. He also covers removal of nouveau in favor of proprietary nvidia drivers

๐Ÿชง๐Ÿชง๐Ÿชง ANNOUNCEMENT ๐Ÿชง๐Ÿชง๐Ÿชง

  • This Repo does not contain Hyprland Dots or configs! Dotfiles can be checked here Hyprland-Dots . During installation, if you opt to copy installation, it will be downloaded from that centralized repo.
  • Hyprland-Dots use are constantly evolving / improving. you can check CHANGELOGS here Hyprland-Dots-Changelogs
  • Since the Hyprland-Dots are evolving, some of the screenshots maybe old
  • the wallpaper offered to be downloaded towards the end is from this REPO

โœจ Some notes on this installer / Prerequisites

  • This script is meant to install in Debian Testing (Trixie).
  • If However, decided to try, recommend to install SDDM. Apart from GDM and SDDM, any other Login Manager may not work nor launch Hyprland. However, hyprland can be launched through tty by type Hyprland
  • ๐Ÿ•ฏ๏ธ network-manager-gnome (nm-applet) has been removed from the packages to install. This is because it is known to restart the networkmanager causing issues in the installation process. After you boot up, inorder to get the network-manager applet, install network-manager-gnome. sudo apt install network-manager-gnome See below if your network or wifi became unmanaged after installation
  • If you have nvidia, and wanted to use proprietary drivers, uninstall nouveau first (if installed). This script will be installing proprietary nvidia drivers and will not deal with removal of nouveau.

โš ๏ธ WARNING! nwg-look takes long time to install.

  • nwg-look is a utility to costumize your GTK theme. It's a LXAppearance like. Its a good tool though but this package is entirely optional

โœจ Costumize the packages to be installed

  • inside the install-scripts folder, you can edit 00-hypr-pkgs.sh. Do not edit 00-dependencies.sh unless you know what you are doing. Care though as the Hyprland Dots may not work properly!
  • default GTK theme if agreed to be installed is Tokyo night GTK themes (dark and light) + Tokyo night SE icons

๐Ÿ’ซ SDDM and GTK Themes offered

  • If you opted to install SDDM theme, here's the LINK
  • If you opted to install GTK Themes, Icons and Cursor offered are Tokyo Nights. LINK & Bibata Cursor Modern Ice

๐Ÿ”” NOTICE TO NVIDIA OWNERS

  • by default it is installing the latest and newest nvidia drivers. If you have an older nvidia-gpu (GTX 800 series and older), check out nvidia-debian website LINK and edit nvidia.sh in install-scripts folder to install proper gpu driver

Important

If you want to use nouveau driver, choose N when asked if you have nvidia gpu. This is because the nvidia installer part, it will blacklist nouveau. Hyprland will still be installed but it will skip blacklisting nouveau.

โœจ to run

clone this repo (latest commit only) by using git. Change directory, make executable and run the script

git clone --depth=1 https://github.com/JaKooLit/Debian-Hyprland.git
cd Debian-Hyprland
chmod +x install.sh
./install.sh

โœจ for ZSH and OH-MY-ZSH installation

installer should auto change your default shell to zsh. However, if it does not, do this

chsh -s $(which zsh)
zsh
source ~/.zshrc
  • reboot or logout
  • by default agnoster theme is installed. You can find more themes from this OH-MY-ZSH-THEMES
  • to change the theme, edit ~/.zshrc ZSH_THEME="desired theme"

โœจ TO DO once installation done and dotfiles copied

  • if you opted to install gtk themes, to apply the theme and icon, press the dark/light button (beside the padlock). To apply Bibata modern ice cursor, launch nwg-look (GTK Settings) through rofi. Hyprland-Dots v2.1.18, initial boot file will attempt to apply GTK themes,cursor, and icons. You can tweak more using nwg-look (GTK-Settings) utility

  • SUPER H for HINT or click on the waybar HINT! Button

  • Head over to FAQ and TIPS

  • if you installed in your laptop and Brightness and Keyboard brightness does not work you can execute this command sudo chmod +s $(which brightnessctl)

โœจ Packages that are manually downloaded and build. These packages will not be updated by apt and have to be manually updated

Tip

To update to latest packages, re-running this script will auto update all. Script is configured to pull latest packages build for you.

๐Ÿคฌ FAQ

Most common question I got is, Hey Ja, Why the heck it is taking long time to install? Other distro like Arch its only a minute or two. Why here takes like forever?!?!?!

  • Well, most of the core packages are downloaded and Build and compiled from SOURCE. There are no pre-built binary (yet) for Debian and Ubuntu. Unlike Other distros, they already have prepacked binary that can just download and install.

โ— some known issues on this Installer

  • some users reported that they have to install some packages. It is in the install-scripts/force-install.sh
  • At this time the packages force to install are the following imagemagick

๐Ÿซฅ Improving performance for Older Nvidia Cards using driver 470

๐Ÿ™‹ Got a questions regarding the Hyprland Dots configurations? ๐Ÿ™‹

  • Head over to wiki Link WIKI

๐Ÿ™‹ ๐Ÿ‘‹ Having issues or questions?

  • for the install part, kindly open issue on this repo
  • for the Pre-configured Hyprland dots / configuration, submit issue here

๐Ÿ”ง Proper way to re-installing a particular script from install-scripts folder

  • CD into Fedora-Hyprland Folder and then ran the below command.
  • i.e. ./install-scripts/gtk-themes - For reinstall GTK Themes.

๐Ÿ›ฃ๏ธ Roadmap:

  • [ ] Install zsh and oh-my-zsh without necessary steps above DONE
  • possibly adding gruvbox themes, cursors, icons

โ— some known issues for nvidia

  • reports from members of my discord, states that some users of nvidia are getting stuck on sddm login. credit to @Kenni Fix stated was
 while in sddm press ctrl+alt+F2 or F3
log into your account
`lspci -nn`, find the id of your nvidia card
`ls /dev/dri/by-path` find the matching id
`ls -l /dev/dri/by-path` to check where the symlink points to 
)
  • add "env = WLR_DRM_DEVICES,/dev/dri/cardX" to the ENVvariables config (.config/hypr/UserConfigs/ENVariables.conf) ; X being where the symlink of the gpu points to

  • more info from the hyprland wiki Hyprland Wiki Link

  • Does not work in Ubuntu 23.04

  • sddm blackscreen when log-out

  • Installing SDDM if or any other Login Manager installed. See Issue 2 - SDDM

  • network is down or become unmanaged This might help

๐Ÿ“’ Final Notes

  • join my discord channel Discord
  • Feel free to copy, re-distribute, and use this script however you want. Would appreciate if you give me some loves by crediting my work :)

๐Ÿ‘๐Ÿ‘๐Ÿ‘ Thanks and Credits!

  • Hyprland Of course to Hyprland and @vaxerski for this awesome Dynamic Tiling Manager.

๐Ÿ’Œ Some screenshots shared to me via discord

  • Discord user : thunderlake. alt text

๐Ÿ’– Support

  • a Star on my Github repos would be nice ๐ŸŒŸ

  • Subscribe to my Youtube Channel YouTube

  • You can also buy me Coffee Through ko-fi.com or Coffee.com ๐Ÿคฉ

Buy Me a Coffee at ko-fi.com

"Buy Me A Coffee"

๐Ÿ“น Youtube videos (Click to view and watch the playlist) ๐Ÿ“น

Youtube Playlist Thumbnail

debian-hyprland's People

Contributors

jakoolit avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.