Skip to content
OpenBox pipemenu for using xrandr
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Creates an interactive pipe menu for the OpenBox window manager to allow users easy access to xrandr information and actions.

Installation Instructions

  1. Download the script:

  2. Put it somewhere that makes sense:

    mv $HOME/.config/openbox
  3. Make it executable:

    chmod 755 $HOME/.config/openbox/
  4. Edit your $HOME/.config/openbox/menu.xml file and put this near the top inside <openbox_menu>:

    <menu id="randr-menu" label="randr" execute="~/.config/openbox/" />
  5. Add this inside the menu section that you want the menu to appear in:

    <menu id="randr-menu" />

Configuration File

You can easily add custom commands to the menu by creating the file $HOME/.ob-randrrc. The syntax looks like this:


portrait: --output LVDS --primary --mode 1366x768 --output VGA-0 --mode 1440x900 --left-of LVDS --rotate left


zoom out: --output LVDS --scale 1.3x1.3
zoom in: --output LVDS --panning 1280x1024

The idea is that you can create machine-specific shortcuts. For example, with my laptop at home I frequently connect to an external widescreen display turned sideways. On my netbook, I frequently 'zoom out' to a higher resolution in scaled-out mode or 'zoom in' to a higher resolution in panning mode.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.