Skip to content

๐Ÿ–ฅ๏ธ Simple tilling manager for arrange your workspace

License

Notifications You must be signed in to change notification settings

zyxidra/littlewin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation


littlewin

littlewin is stand for "Window Management", a window management tool inspired by tiling window managers. Unlike tiling window managers, littlewin allows you to manage application windows without relying on a full tiling manager. It's designed to provide flexibility for arranging and managing windows in a non-intrusive way, without imposing a tiling window management style.

This project is mainly targeted for users who prefer to manage windows in a more manual, customizable fashion while still benefiting from automation in tasks such as window resizing, arrangement, and workspace management. โš™๏ธ

Layout Visualizations

Here are various layout arrangements for windows. The configurations showcase how windows can be arranged in different layouts.


Single Window Layout

+-----------------------+
|                       |
|                       |
|                       |
|           1           |
|           ^           |
|                       |
|                       |
+-----------------------+

Two Window Layouts

Horizontal Split

+-----------------------+
|           |           |
|           |           |
|           |           |
|     1     |     2     |
|     ^     |     ^     |
|           |           |
|           |           |
+-----------------------+

Vertical Split

+-----------------------+
|           |           |
|           |     2     |
|           |           |
|     1     |-----------|
|     ^     |           |
|           |     3     |
|           |     ^     |
+-----------------------+

Three Window Layout

Centered Split

+-----------------------+
|           |           |
|     1     |     2     |
|     ^     |           |
|-----------|-----------|
|           |           |
|     4     |     3     |
|           |           |
+-----------------------+

Note ๐Ÿ“Œ:

Currently, littlewin only supports Linux with X11. It wonโ€™t work on Wayland or other windowing systems, and itโ€™s not available on other operating systems (like macOS or Windows) at this time.


Installation ๐Ÿ› ๏ธ

Dependencies ๐Ÿ“ฆ

Make sure you have the following installed:

  • X11 development libraries (libx11-dev) ๐Ÿ–ฅ๏ธ
  • X11 utilities like xprop ๐Ÿ”ง
  • Other standard libraries for C development (e.g., gcc, cmake) ๐Ÿ› ๏ธ

Clone the Repository ๐Ÿ“‚

git clone https://github.com/zyxidra/littlewin.git
cd littlewin
chmod +x install.sh
./install.sh

Build the Project โš™๏ธ

If you're using make, run the following commands to build littlewin:

make

Alternatively, if you're using CMake, create a build directory and run the following commands:

mkdir build
cd build
cmake ..
make

Usage ๐Ÿš€

Once compiled, you can run the littlewin executable to manage your windows. For example:

./littlewin

Development ๐Ÿง‘โ€๐Ÿ’ป

This project is open-source, and contributions are welcome. If you'd like to contribute, please fork the repository, create a branch, and submit a pull request with your changes. ๐Ÿ› ๏ธ

For further development, you may also want to modify the configuration settings based on your preferred window manager (e.g., X11, Wayland).


Acknowledgements ๐Ÿ™

  • Inspired by tiling window managers. ๐Ÿ’ก
  • Thanks to the X11 community for providing useful tools like xprop and xwininfo. ๐Ÿ‘

Alternative


About

๐Ÿ–ฅ๏ธ Simple tilling manager for arrange your workspace

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published