Shell-utils

1 minute read
,

Overview

Welcome to the Shell Utilities repository This project provides a collection of shell scripts tailored for different window managers and environments, including i3, Hyprland, and Sway, on X11 and Wayland.

Repository Structure

The repository is organized into directories based on the environment and window manager:

1.
2├── wayland
3│   ├── hyprland
4│   └── sway
5└── x11
6    └── i3
wayland/hyprland
Scripts for Hyprland on Wayland.
wayland/sway
Scripts for Sway on Wayland.
x11/i3
Scripts for i3 on X11.

Installation

To install the scripts, use the provided install.sh script. You can install scripts for a specific window manager or all at once.

NOTE: The install.sh scripts use $HOME/.local/bin as the target, you can edit this variable inside the script, or copy the files manually somewhere as you have your path.

1# Install scripts for a specific window manager
2./install.sh sway
3./install.sh hyprland
4./install.sh i3
5
6# Install all scripts
7./install.sh all

Usage

Each script includes usage instructions in the comments at the top. You can run a script directly from the terminal or integrate it into your workflow.

Contributing

We welcome contributions! If you’d like to contribute, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or fix.
  3. Make your changes and commit them with descriptive messages.
  4. Push your changes to your fork.
  5. Submit a pull request to the main repository.

Contact

For questions or suggestions, please open an issue on GitHub or contact Javier Pacheco.