Reworked README
This commit is contained in:
68
README.md
68
README.md
@@ -1,19 +1,22 @@
|
|||||||
#+TITLE: hyprland-toggle-tiling
|
<div align="center">
|
||||||
#+AUTHOR: Your Name
|
<img src="assets/icon.svg" alt="HTT logo" width="120" height="120"/>
|
||||||
#+OPTIONS: toc:nil
|
|
||||||
|
|
||||||
[](https://cplusplus.com/)
|
# HTT - Hyprland Toggle Tiling
|
||||||
|
|
||||||
|
[](https://cplusplus.com/)
|
||||||
[](https://hyprland.org/)
|
[](https://hyprland.org/)
|
||||||
[](https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/src/branch/master/LICENSE)
|
[](https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/src/branch/master/LICENSE)
|
||||||
[](https://github.com/username/anny-dock/graphs/commit-activity)
|
)](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.
|
A simple program to toggle tiling and floating modes for windows in the Hyprland Wayland compositor.
|
||||||
|
|
||||||
[[https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/src/branch/master/assets/demo.webm][See demo]]
|
[https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/src/branch/master/assets/demo.webm](See demo)
|
||||||
[[./assets/demo.webm]]
|

|
||||||
|
|
||||||
* Features
|
</div>
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
- Quickly switch between tiling and floating modes for all windows on the active workspace.
|
- 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.
|
- After switching, the program creates a hyprland config file to respect the new windowing mode.
|
||||||
@@ -25,62 +28,61 @@ A simple program to toggle tiling and floating modes for windows in the Hyprland
|
|||||||
- Useful for workflows that require both tiling and floating window management.
|
- Useful for workflows that require both tiling and floating window management.
|
||||||
- Lightweight and easy to integrate with your Hyprland setup.
|
- Lightweight and easy to integrate with your Hyprland setup.
|
||||||
|
|
||||||
* Installation
|
## Installation
|
||||||
|
|
||||||
** Install from AUR
|
### Install from AUR
|
||||||
|
|
||||||
You may install this program [[https://aur.archlinux.org/packages/hyprland-toggle-tiling-git][from the AUR.]]
|
You may install this program [https://aur.archlinux.org/packages/hyprland-toggle-tiling-git](from the AUR.)
|
||||||
|
|
||||||
** Download the release
|
### Download the release
|
||||||
|
|
||||||
[[https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/releases/tag/1.1.0][Download the release binary]].
|
[https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling/releases/tag/1.1.0](Download the release binary).
|
||||||
|
|
||||||
|
### Compile from source
|
||||||
** Compile from source
|
|
||||||
|
|
||||||
1. Clone this repository:
|
1. Clone this repository:
|
||||||
#+BEGIN_SRC shell
|
```shell
|
||||||
git clone https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling.git
|
git clone https://typofelho.ddns.net/TypoMustakes/hyprland-toggle-tiling.git
|
||||||
#+END_SRC
|
```
|
||||||
|
|
||||||
2. Enter project directory:
|
2. Enter project directory:
|
||||||
#+BEGIN_SRC shell
|
```shell
|
||||||
cd hyprland-toggle-tiling/
|
cd hyprland-toggle-tiling/
|
||||||
#+END_SRC
|
```
|
||||||
|
|
||||||
3. Create build directory:
|
3. Create build directory:
|
||||||
#+BEGIN_SRC shell
|
```shell
|
||||||
cmake -S . -B build/
|
cmake -S . -B build/
|
||||||
#+END_SRC
|
```
|
||||||
|
|
||||||
4. Enter build directory:
|
4. Enter build directory:
|
||||||
#+BEGIN_SRC shell
|
```shell
|
||||||
cd build/
|
cd build/
|
||||||
#+END_SRC
|
```
|
||||||
|
|
||||||
5. Build the projects:
|
5. Build the projects:
|
||||||
#+BEGIN_SRC shell
|
```shell
|
||||||
cmake --build .
|
cmake --build .
|
||||||
#+END_SRC
|
```
|
||||||
|
|
||||||
* Usage
|
# Usage
|
||||||
#+BEGIN_SRC shell
|
```shell
|
||||||
./htt <config-file-path>
|
./htt <config-file-path>
|
||||||
#+END_SRC
|
```
|
||||||
- If the specified configuration file does not exist, it will be created.
|
- 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.
|
- 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
|
# Integration with Hyprland
|
||||||
1. Whatever configuration path you specify, include it in your Hyprland config, like so:
|
1. Whatever configuration path you specify, include it in your Hyprland config, like so:
|
||||||
~~/path/to/your/hyprland.conf~:
|
~~/path/to/your/hyprland.conf~:
|
||||||
#+BEGIN_SRC conf
|
```conf
|
||||||
source = ~/path/to/specified/config/file.conf
|
source = ~/path/to/specified/config/file.conf
|
||||||
#+END_SRC
|
```
|
||||||
|
|
||||||
2. Bind the script to a key in your Hyprland config:
|
2. Bind the script to a key in your Hyprland config:
|
||||||
#+BEGIN_SRC conf
|
```conf
|
||||||
bind = $mod + t, exec, /path/to/htt <config-file-path>
|
bind = $mod + t, exec, /path/to/htt <config-file-path>
|
||||||
#+END_SRC
|
```
|
||||||
|
|
||||||
Or not. Do whatever you want.
|
Or not. Do whatever you want.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user