Initial commit

uconsole-rotate/README.md

@@ -0,0 +1,27 @@
+# uconsole-rotate
+
+Command-line helper to rotate the uConsole display on Wayland (sway/wayfire) using wlr-randr.
+
+## Important
+
+This rotation is not persisted across reboots. Re-run the command after login or add it to your session autostart if you want it applied automatically.
+
+I use this to quickly rotate the display to play games in other orientations.
+
+## Usage
+
+```
+uconsole-rotate [right|left|0|90|180|270]
+```
+
+- No argument: rotate 90° clockwise from current orientation
+- right/left: rotate relative to current orientation
+- 0/90/180/270: set rotation (device-specific mapping handled internally)
+
+## Notes
+
+- Automatically detects the DSI output
+- Requires a Wayland session with `wlr-randr` available
+- Exits with non-zero status if no DSI output is found or transform cannot be resolved
+
+