Skip to content

Commit

Permalink
Update docs.
Browse files Browse the repository at this point in the history
  • Loading branch information
clsty committed Feb 10, 2024
1 parent 5d75930 commit 2380182
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 8 deletions.
23 changes: 17 additions & 6 deletions src/content/docs/en/i-i/01.setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ layout: /src/layouts/autonum.astro
1. Below process only provides user-level customization and is NOT a complete solution for a fresh install. You have to set up network, bluetooth, nvidia stuff, etc. yourself
2. The author personally use (and highly recommend) EndeavourOS GNOME to not have to deal with all that hassle. Though you can use regular Arch just fine. It's never necessary to reinstall your system for this!
3. If your distro isn't Arch(-based), you'll have to figure out the equivalents of packages below.
4. If you only have 8Gb of ram, you might wanna [set up zram](https://forum.endeavouros.com/t/enabling-zram-in-endeavouros/37746) (or swap) before starting the installation, since compiling Hyprland takes quite a bit of resources.
4. If you only have 8GiB of RAM, you might wanna [set up zram](https://forum.endeavouros.com/t/enabling-zram-in-endeavouros/37746) (or swap) before starting the installation, since compiling Hyprland takes quite a bit of resources.

## Automated installation (Arch distros only)
## Automated installation (Arch distros only; Recommended)
Clone, checkout this branch, then run install script:
```bash
cd ~/Downloads # Let's not trash your home folder
Expand All @@ -22,11 +22,10 @@ cd dots-hyprland && git checkout illogical-impulse
This script is idempotent, which means that you can run it multiple times.

## Manual installation
- Get packages and add user to `video` and `input` group
- Get packages: Install all packages listed inside `scriptdata/dependencies.conf` using AUR helper such as `yay`.
- Add user to `video` and `input` group
```bash
yay -S blueberry brightnessctl cliphist coreutils curl fish foot fuzzel gjs gnome-bluetooth-3.0 gnome-control-center gnome-keyring gobject-introspection grim gtk3 gtk-layer-shell libdbusmenu-gtk3 meson networkmanager npm plasma-browser-integration playerctl polkit-gnome python-pywal ripgrep sassc slurp starship swayidle typescript upower xorg-xrandr webp-pixbuf-loader wget wireplumber wl-clipboard tesseract yad ydotool adw-gtk3-git cava gojq gradience-git hyprland-git hyprpicker-git lexend-fonts-git python-material-color-utilities python-pywal python-poetry python-build python-pillow ttf-material-symbols-variable-git ttf-space-mono-nerd swaylock-effects-git ttf-jetbrains-mono-nerd wayland-idle-inhibitor-git wlogout wlsunset-git
sudo usermod -aG video $(whoami) # if this somehow doesn't work, just replace "$(whoami)" with your username
sudo usermod -aG input $(whoami) # same for this
sudo usermod -aG video,input "$(whoami)" # if this somehow doesn't work, just replace "$(whoami)" with your username
```
- Install AGS **FROM SOURCE** (the AUR package is NOT up-to-date)
```bash
Expand Down Expand Up @@ -54,6 +53,18 @@ This script is idempotent, which means that you can run it multiple times.
- For [Chromium](https://chrome.google.com/webstore/detail/plasma-integration/cimiefiiaegbelhefglklhhakcgmhkai)
- For [Firefox](https://addons.mozilla.org/en-US/firefox/addon/plasma-integration/)

# Update
## Automatically installed
Run `./install.sh` again, and skip the steps which you do NOT want (especially the `rsync ...` ones because it will **override your files under its target path**).

To only update AGS, simply run `./update-ags.sh`.
## Manually installed
Run `git pull` under the git repo to get the latest update.

Then grab things manually, similar to manual installation.

To only update AGS, simply run `./update-ags.sh`.

# Uninstallation
Currently, there's a script for uninstallation, but it's far from perfect and is not actively maintained.

Expand Down
11 changes: 9 additions & 2 deletions src/content/docs/en/i-i/03.troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,11 +41,18 @@ consider the following steps:
3. Restart firefox with the new profile and try again.

Note: `playerctl -F metadata` may also be helpful for debugging.
## Firefox sometimes crashes
When this happens, please use `(xWayland) Firefox`, which desktop file is provided in `~/.local/share/applications` with `env MOZ_ENABLE_WAYLAND=0` for `Exec` entry.
## Firefox crashes when open certain web page
Run firefox again from terminal using:
```bash
env MOZ_ENABLE_WAYLAND=0 firefox
```
And see if it crashes again.

This is just a workround, which makes Firefox running under xWayland.

If this solves your problem, you may also find the problem disappears for firefox under wayland some other day.
Therefore, you may copy the original desktop file `/usr/share/applications/firefox.desktop` to `~/.local/share/applications/xfirefox.desktop` and edit as `Name=X Firefox` and `Exec=env MOZ_ENABLE_WAYLAND=0 /usr/lib/firefox/firefox %u`, so that you can use firefox under xwayland when the problem appears again.

## ags installation failed
### `PermissionError: [Errno 13] Permission denied: '/usr/local/lib/libgvc.so'`
Run:
Expand Down

0 comments on commit 2380182

Please sign in to comment.