Project

HyprRotation

A small shell-based Hyprland helper for rotating connected monitors quickly from the command line without manually editing config files or retyping monitor transforms.

Open GitHub Repo

The current live repo is built around hypr_rotation.sh. Older Python versions are kept separately as legacy approaches, not the main public entrypoint.

What It Does

The shell script validates the requested rotation mode, detects connected monitors from hyprctl monitors, and applies the corresponding Hyprland transform to each one.

Why I Built It

This project came from wanting a quick repeatable way to flip a Hyprland display setup between orientations without dropping back into manual monitor commands every time.

Quick Start

Shell Usage

Direct Use

chmod +x hypr_rotation.sh
./hypr_rotation.sh normal
./hypr_rotation.sh right
./hypr_rotation.sh down
./hypr_rotation.sh left

Requirements

bash
hyprctl
a running Hyprland session

Shell Setup

Bash Aliases

Install Path

mkdir -p "$HOME/.local/bin"
cp hypr_rotation.sh "$HOME/.local/bin/hypr_rotation.sh"
chmod +x "$HOME/.local/bin/hypr_rotation.sh"

~/.bashrc

alias nom="$HOME/.local/bin/hypr_rotation.sh normal"
alias rot="$HOME/.local/bin/hypr_rotation.sh right"
alias down="$HOME/.local/bin/hypr_rotation.sh down"
alias lef="$HOME/.local/bin/hypr_rotation.sh lef"
alias left="$HOME/.local/bin/hypr_rotation.sh left"

source ~/.bashrc

Stack

Technical Notes

Bash automation around hyprctl.
Applies Hyprland monitor transforms directly to detected monitors.
Current repo keeps older Python config-editing versions only as legacy references.

License

Usage Notice

This page is the portfolio overview. The published source and license terms live in the GitHub repository for the current shell-based version.