diff --git a/astro.config.mjs b/astro.config.mjs index 433fd97..f645c6a 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -57,6 +57,7 @@ export default defineConfig({ { label: 'Shell', link: '/en/configuration/shell' }, { label: 'Display Manager', link: '/en/configuration/display-manager' }, { label: 'GNOME', link: '/en/configuration/gnome' }, + { label: 'Bspwm', link: '/en/configuration/bspwm' }, { label: 'Hyprland', link: '/en/configuration/hyprland' }, { label: 'NVIDIA GPU', link: '/en/configuration/nvidia' }, { label: 'Repositories', link: '/en/configuration/repositories' }, diff --git a/src/assets/images/bspwm-aline.png b/src/assets/images/bspwm-aline.png new file mode 100644 index 0000000..e1f77bf Binary files /dev/null and b/src/assets/images/bspwm-aline.png differ diff --git a/src/assets/images/bspwm-bar.png b/src/assets/images/bspwm-bar.png new file mode 100644 index 0000000..70d909f Binary files /dev/null and b/src/assets/images/bspwm-bar.png differ diff --git a/src/assets/images/bspwm-cristina.png b/src/assets/images/bspwm-cristina.png new file mode 100644 index 0000000..e1315f2 Binary files /dev/null and b/src/assets/images/bspwm-cristina.png differ diff --git a/src/assets/images/bspwm-cynthia.png b/src/assets/images/bspwm-cynthia.png new file mode 100644 index 0000000..170450e Binary files /dev/null and b/src/assets/images/bspwm-cynthia.png differ diff --git a/src/assets/images/bspwm-karla.png b/src/assets/images/bspwm-karla.png new file mode 100644 index 0000000..7b27497 Binary files /dev/null and b/src/assets/images/bspwm-karla.png differ diff --git a/src/assets/images/bspwm-melissa.png b/src/assets/images/bspwm-melissa.png new file mode 100644 index 0000000..8c9b4fc Binary files /dev/null and b/src/assets/images/bspwm-melissa.png differ diff --git a/src/assets/images/bspwm-pamela.png b/src/assets/images/bspwm-pamela.png new file mode 100644 index 0000000..5a9e648 Binary files /dev/null and b/src/assets/images/bspwm-pamela.png differ diff --git a/src/assets/images/bspwm-rices.png b/src/assets/images/bspwm-rices.png new file mode 100644 index 0000000..aded53a Binary files /dev/null and b/src/assets/images/bspwm-rices.png differ diff --git a/src/assets/images/bspwm-silvia.png b/src/assets/images/bspwm-silvia.png new file mode 100644 index 0000000..9fdfbe1 Binary files /dev/null and b/src/assets/images/bspwm-silvia.png differ diff --git a/src/assets/images/bspwm-z0mbi3.png b/src/assets/images/bspwm-z0mbi3.png new file mode 100644 index 0000000..f73b444 Binary files /dev/null and b/src/assets/images/bspwm-z0mbi3.png differ diff --git a/src/components/TimelineComponent.astro b/src/components/TimelineComponent.astro index 364b90c..ffc71c2 100644 --- a/src/components/TimelineComponent.astro +++ b/src/components/TimelineComponent.astro @@ -31,8 +31,8 @@ import "/src/styles/timeline.scss";
Milestone Q4
-
- Bspwm Support +
+ Bspwm Support
diff --git a/src/content/docs/en/configuration/bspwm.mdx b/src/content/docs/en/configuration/bspwm.mdx new file mode 100644 index 0000000..a6434db --- /dev/null +++ b/src/content/docs/en/configuration/bspwm.mdx @@ -0,0 +1,163 @@ +--- +title: Bspwm +description: Bspwm environment in Athena OS. +--- +import ImageComponent from "@components/ImageComponent.astro"; +import ThemedImage from '@components/ThemedImage.astro'; + +[Bspwm](https://wiki.archlinux.org/title/bspwm) is a tiling window manager that represents windows as the leaves of a full binary tree. + +In Athena OS, Bspwm shows different rices to fit the best workspace environment the user would like to work on. + +![Bspwm Environment](@assets/images/bspwm-rices.png) + +The environment consists of several elements that will shown in this chapter. + +Each Bspwm rice has its own bar but they provides common features: + +![Bspwm Bar](@assets/images/bspwm-bar.png) + +#### Application Menu +By clicking on Arch logo icon, or by pressing **SUPER + SPACE** on your keyboard, the Application Menu will spawn. Here, you can find and open any installed application you wish to run. + +![Bspwm Application Menu](@assets/images/gnome-softwarecenter.png) + +#### Window Switcher +Some rices have an icon showing overlapping windows that help you to switch among opened windows. + +![Bspwm Window Switcher](@assets/images/gnome-arcmenu.png) + +You can also spawn it by pressing **CTRL + ALT + W**. + +#### Workspaces +All the rices allow you to switch among workspaces. The difference of workspace menu inside each rice consists only of icons: glyphs or numbers. + +#### Hack The Box Toolkit +Bspwm environment integrates with Hack The Box platform. TODO + +![HTB Toolkit](@assets/images/gnome-calendar.png) + +#### System Metrics + +On the bar, you can find some metrics about the system resource consumption like brightness percentage, disk space, CPU and RAM usage. + +By clicking on the disk space icon, you can mount any existing drives (i.e., disk, partition or USB drives) to your system. + +![Bspwm Mount](@assets/images/gnome-monitor.png) + +As example, if you would like to use your USB drive, plug it in your computer, click on disk space icon, and on the popup window move to **Mount** and press **Enter**. You will get a list of drives, and among them, you will get the disk and the partition of your USB drive, for example in my case: +``` +/dev/sdb (14.6 G) disk +/dev/sdb1 (14.6 G) part +``` +You must select the **part** element in order to see the files inside your USB drive. Then, a name of folder where the USB drive should be mounted will be asked to you, and, finally, you can access to it by `ls /mnt/d_mount/`. + +Once you finished your activity by USB drive, you can unmount it by clicking on disk space icon, move to **Umount** and press **Enter**. + +#### System Icons + +WiFi icon allows you to connect to a network while Bluetooth one to a Bluetooth device. In this part of the bar, you can also tune your volume and update your packages. + +Finally, a power icon button allows you to logout, lock, restart or shutdown your system. + +## Desktop + +The desktop is pretty simple in terms of elements. You have mainly a bar and a wallpaper. + +If you wish to change your rice, press **ALT + SPACE** on your keyboard. A popup window containing the list of the rices appears: + +![Bspwm Rices](@assets/images/gnome-applications.png) + +Select your favourite and press **Enter**. + +## Keybindings + +Here are reported some useful **keybindings** set by default in Athena OS GNOME. + +### Application and System Management + +| Keybind | Description | +| ------- | ----------- | +| **Super + Enter** | Open the Terminal | +| **Super + ALT + Enter** | Open floating Terminal | +| **Super + Space** | Open application menu | +| **Super + \{H, U\}** | Hide/Show menu bar | +| **Super + ALT + W** | Set random wallpaper | +| **ALT + Space** | Open rice selector | +| **CTRL + ALT + W** | Active window list | +| **Print** | Open screenshot pane | +| **Super + K** | Hack The Box spawn machine | +| **Super + Shift + K** | Hack The Box machine details | +| **Super + SHIFT + I** | Hack The Box VPN | +| **Super + ALT + O** | Open scratchpad | +| **CTRL + Super + ALT + \{P, R, Q, L, K\}** | Power off, Reboot, Log out, Lock screen, Kill an app | +| **Shift + ALT + B** | Open browser | +| **Shift + ALT + G** | Open VSCodium | +| **Shift + ALT + E** | Open File Manager | +| **Shift + ALT + P** | Open Pavucontrol | +| **Shift + ALT + R** | Open Ranger | +| **Shift + ALT + W** | Open Athena Welcome | +| **Shift + ALT + M** | Open Virt-Manager | +| **Shift + ALT + V** | Open Neovim | +| **Shift + ALT + K** | Open music | +| **Super + \{*self*, Shift\} + Q** | Close or kill the focused window | + +:::note +*self* indicates that you don't need to press anything on your keyboard to run an action. For example, **Super + \{*self*, Shift\} + Q** means: +* **Super + Q** closes the focused window +* **Super + Shift + Q** kills the focused window +::: + +### Desktop and Window Selection + +| Keybind | Description | +| ------- | ----------- | +| **CTRL + ALT + \{+, -, R\}** | Change transparency on focused window | +| **Super + R** | Rotate desktop elements of 90 degree | +| **Super + C** | Rotate the leaves of the element tree | +| **Super + =** | Make split ratio equal | +| **Super + -** | Make split ratio balanced (use 'dash' key for minus character) | +| **Super + M** | Make focused window maximized | +| **Super + G** | Swap the focused window by the biggest opened window | +| **Super + \{T, Shift + T, S, F\}** | Set the window state as tiled, pseudo tiled, floating or fullscreen | +| **CTRL + ALT + \{M, X, S, P, I\}** | Set the window flag as marked, locked, sticky, private, hidden | +| **Super + \{4, 5\}** | Focused window gaps scroll | +| **Super + ALT + \{4, 5\}** | Global window gaps scroll | +| **Super + \{*self*, Shift\} + \{Left, Down, Up, Right\}** | Focus the window in the given direction | +| **ALT + \{*self*, Shift\} + TAB** | Focus to the next or previous window in the current desktop | +| **Super + ALT + \{Left, Right\}** | Move among workspaces | +| **Super + \{\`, TAB\}** | Focus the last window or desktop | +| **Super + \{O, I\}** | Focus the older or newer window in the focus history | +| **ALT + \{*self*, Shift\} + \{1-9,0\}** | Focus or move a window to the selected workspace | + +### Desktop and Window Preselection + +| Keybind | Description | +| ------- | ----------- | +| **Super + CTRL + \{Left, Down, Up, Right\}** | Preselect the direction | +| **Super + CTRL + \{1-9\}** | Preselect the ratio | +| **Super + CTRL + Space** | Cancel the preselection for the focused window | +| **Super + CTRL + Shift + Space** | Cancel the preselection for the focused workspace | + +### Window Move/Resize + +| Keybind | Description | +| ------- | ----------- | +| **Super + ALT + \{H, J, K, L\}** | Expand a window by moving one of its side outward | +| **Super + ALT + Shift + \{H, J, K, L\}** | Contract a window by moving one of its side inward | +| **ALT + Shift + \{Left, Down, Up, Right\}** | Move a floating window | + +### Second Monitor +| Keybind | Description | +| ------- | ----------- | +| **Super + ALT + Shift + \{Left, Right\}** | Send window to the second monitor | + +### Bspwm Management + +| Keybind | Description | +| ------- | ----------- | +| **Super + Esc** | Reload sxhkdrc | +| **Super + ALT + R** | Reload Bspwm | + + + diff --git a/src/content/docs/en/support/troubleshooting.mdx b/src/content/docs/en/support/troubleshooting.mdx index 017c8bc..5f6473c 100644 --- a/src/content/docs/en/support/troubleshooting.mdx +++ b/src/content/docs/en/support/troubleshooting.mdx @@ -476,4 +476,8 @@ and select the **Linux Kernel** to run ![Athena Snapshots Run](@assets/images/athena-snapshots-run.png) +#### Cannot store HTB App Token due to secret-tool hanging + +When you run `htb-toolkit -k set` and, by entering your App Token in the Password field secret-tool hangs, try to reboot the system. If it does not work, install Brave browser, open it and at first run a popup window asking for the creation of a new password is shown. You can choose to set a password or just press **Enter** two times if you don't want, and finally try again `htb-toolkit -k set`. +