-
Notifications
You must be signed in to change notification settings - Fork 18
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
8 changed files
with
181 additions
and
70 deletions.
There are no files selected for viewing
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,75 @@ | ||
| --- | ||
| title: Usage | ||
| layout: /src/layouts/autonum.astro | ||
| --- | ||
|
|
||
| # General | ||
| - For a list of keybinds, hit `Super`+`/` | ||
| - just play around with it a bit and click everywhere ;) this just documents some non-obvious stuff | ||
|
|
||
| # Overview/launcher | ||
| Press `Super` to open. | ||
|
|
||
| - **Windows** | ||
| - Drag to move them to different workspaces | ||
| - Right-click for a few options | ||
| - **Search** | ||
| - <u>Calculation</u>: Type something starting with a number | ||
| - <u>Commands</u>: They'll be detected and shown to you if you type in. | ||
| - Performs a headless execution by default | ||
| - If the command starts with sudo, it'll be launched in `foot` terminal. | ||
| - <u>Directory search</u>: Type a directory starting with `~` or `/`. | ||
| - Subdirectories will be shown if the path is correct. Activating opens folder/file | ||
| - Hit enter directly on the entry to open the typed folder/file | ||
| - <u>Actions</u>: An actions starts with `>`. See the keybind cheatsheet for a list of actions | ||
| - <u>Apps</u> by default, of course! | ||
|
|
||
| # Bar controls | ||
| - Media: | ||
| - Top-right corner | ||
| - Middle-click to play/pause media, Right-click for next track | ||
| - Scroll to change volume | ||
| - Click the music pill for a controls window | ||
| - Brightness: Scroll top-left corner | ||
| - Launcher: Middle-click workspace widget | ||
| - Virtual keyboard: Right-click workspace widget | ||
|
|
||
| # Misc | ||
| ## How to resize | set resolution | font size | ||
| Reference: <https://github.com/end-4/dots-hyprland/issues/180#issuecomment-1880385893> | ||
|
|
||
| You can use gsettings to change the font size, like this: | ||
| ```bash | ||
| gsettings set org.gnome.desktop.interface font-name 'Rubik 9' | ||
| ``` | ||
| Rubik here is the font name and 9 is the font size in pt (1pt = 1.3333 px) | ||
|
|
||
| Stuff should scale according to the font size. Some ags element may need a restart of ags to take effect. | ||
|
|
||
| If some elements are wayy too big, then it's possible that css totally not working, see <https://github.com/end-4/dots-hyprland/issues/226>. | ||
|
|
||
| ## How to change time format | ||
| Reference: <https://github.com/end-4/dots-hyprland/issues/228> | ||
|
|
||
| **NOTE**: You may need to run `man date` for time format. | ||
|
|
||
| For AGS bar (it's not a dock bar I guess), you should edit `~/.config/ags/widgets/bar/system.js`. | ||
| Find `"%H:%M"` there and change it to what you like. | ||
| Its format may refer to [this page](https://docs.gtk.org/glib/method.DateTime.format.html). | ||
|
|
||
| The lockscreen is swaylock currently. Edit its config in `~/.config/swaylock/config` to suit your needs. | ||
| For time format you need to adjust `timestr`. | ||
|
|
||
| ## How to copy text in notification | ||
| Reference: <https://github.com/end-4/dots-hyprland/issues/224#issuecomment-1923706599> | ||
|
|
||
| Click and hold a notification for a while, and its content will be copied. | ||
|
|
||
| ## How to set city for weather | ||
| Reference: <https://github.com/end-4/dots-hyprland/issues/220#issuecomment-1923793627> | ||
| <https://github.com/end-4/dots-hyprland/commit/c2d3c5bce37dd87f19bf5e13002b2af6e0e1e5eb> | ||
|
|
||
| The value will be used as `${city}` for `curl https://wttr.in/lujiang${city}?format=j1`. | ||
|
|
||
| By default the value comes from `curl ipinfo.io`. | ||
| You can also manually set the value by setting the env var `$AGS_WEATHER_CITY`. |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,63 @@ | ||
| --- | ||
| title: Steps for troubleshooting | ||
| layout: /src/layouts/autonum.astro | ||
| --- | ||
|
|
||
| # Hints | ||
|
|
||
| The bar, and the side bars, cheatsheet, etc. belongs to AGS. | ||
|
|
||
| To restart AGS and see its debug info, you may need to run this in terminal (by default press `Super+T` to open one): | ||
| ```bash | ||
| pkill ags;ags | ||
| ``` | ||
| And see if there're any errors, CRITICALs and WARNINGs. | ||
|
|
||
| > Use some common sense. If you can't figure out, open an issue/discussion and we'll try to help. | ||
| # Troubleshooting list | ||
|
|
||
| ## The player panel does not pop up when there is media playing | ||
| > Reference: [end-4/dots-hyprland#168](https://github.com/end-4/dots-hyprland/issues/168) | ||
| Your player must have mpris support (see supported client [here](https://wiki.archlinux.org/title/MPRIS)). | ||
|
|
||
| If you are using firefox as player, Plasma Integration extension should be installed and enabled for firefox, and the package `plasma-browser-integration` should be installed on Arch Linux. | ||
|
|
||
| Then, when firefox is playing media, the following command: | ||
| ```bash | ||
| dbus-send --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.ListNames|grep mpris | ||
| ``` | ||
| should at least return | ||
| ```plain | ||
| string "org.mpris.MediaPlayer2.plasma-browser-integration" | ||
| ``` | ||
| note that output like `string "org.mpris.MediaPlayer2.firefox.instance_1_37"` does NOT work. | ||
|
|
||
| If for some reason, firefox still does not have dbus `org.mpris.MediaPlayer2.plasma-browser-integration` showing up, | ||
| consider the following steps: | ||
| 1. Create a new profile using `firefox --ProfileManager`. | ||
| 2. Launch firefox with the newprofile and install the Plasma Integration extension again. | ||
| 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. | ||
|
|
||
| This is just a workround, which makes Firefox running under xWayland. | ||
|
|
||
| ## ags installation failed | ||
| ### `PermissionError: [Errno 13] Permission denied: '/usr/local/lib/libgvc.so'` | ||
| Run: | ||
| ```bash | ||
| pacman -Qo /usr/local/lib/libgvc.so | ||
| ``` | ||
| to check whether this file belongs to any package (very likely not, because it's inside `/usr/local`). | ||
|
|
||
| If not, then it's probably safe to just remove it. If you're sure about that, run this: | ||
| ```bash | ||
| sudo mv /usr/local/lib/libgvc.so /tmp/ | ||
| ``` | ||
| ### Other errors | ||
| Delete `./cache/ags` and install it again. | ||
|
|
This file was deleted.
Oops, something went wrong.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters