90 lines
3.1 KiB
Markdown
90 lines
3.1 KiB
Markdown
<div align="center">
|
|
<img src="assets/icon.svg" alt="HTT logo" width="120" height="120"/>
|
|
|
|
# HTT - Hyprland Toggle Tiling
|
|
|
|
[](https://cplusplus.com/)
|
|
[](https://hyprland.org/)
|
|
[](https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/src/branch/master/LICENSE)
|
|
[](https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/graph)
|
|
|
|
A simple program to toggle tiling and floating modes for windows in the Hyprland Wayland compositor.
|
|
|
|
<video width="320" height="240" controls>
|
|
<source src="./assets/demo.webm" type="video/webm">
|
|
</video>
|
|
|
|
</div>
|
|
|
|
## Features
|
|
|
|
- Quickly switch between tiling and floating modes for all windows on the active workspace.
|
|
- After switching, the program creates a hyprland config file to respect the new windowing mode.
|
|
|
|
Let's say you switched to tiling mode. From that point on, new windows will open in tiling mode as well.
|
|
|
|
Switch to floating mode again and newly opened windows will be in floating mode.
|
|
- Floating/tiling window rules are isolated between workspaces. You can set one workspace to be floating, and all the rest to tiling for example.
|
|
- Useful for workflows that require both tiling and floating window management.
|
|
- Lightweight and easy to integrate with your Hyprland setup.
|
|
|
|
## Installation
|
|
|
|
### Install from AUR
|
|
|
|
You may install this program [from the AUR.](https://aur.archlinux.org/packages/hyprland-toggle-tiling-git)
|
|
|
|
### Download the release
|
|
|
|
[Download the release binary.](https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/releases/tag/1.1.0)
|
|
|
|
### Compile from source
|
|
|
|
1. Clone this repository:
|
|
```shell
|
|
git clone https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling.git
|
|
```
|
|
|
|
2. Enter project directory:
|
|
```shell
|
|
cd hyprland-toggle-tiling/
|
|
```
|
|
|
|
3. Create build directory:
|
|
```shell
|
|
cmake -S . -B build/
|
|
```
|
|
|
|
4. Enter build directory:
|
|
```shell
|
|
cd build/
|
|
```
|
|
|
|
5. Build the projects:
|
|
```shell
|
|
cmake --build .
|
|
```
|
|
|
|
# Usage
|
|
```shell
|
|
./htt <config-file-path>
|
|
```
|
|
- If the specified configuration file does not exist, it will be created.
|
|
- If the configuration contains existing rules, this should still work, but your existing configuration will probably get a bit messy, syntax-wise. I advise against it.
|
|
|
|
# Integration with Hyprland
|
|
1. Whatever configuration path you specify, include it in your Hyprland config, like so:
|
|
~~/path/to/your/hyprland.conf~:
|
|
```conf
|
|
source = ~/path/to/specified/config/file.conf
|
|
```
|
|
|
|
2. Bind the script to a key in your Hyprland config:
|
|
```conf
|
|
bind = $mod + t, exec, /path/to/htt <config-file-path>
|
|
```
|
|
|
|
Or not. Do whatever you want.
|
|
|