Difference between revisions of "Openbox"

1,942 bytes added ,  5 years ago
Generalized and merged content from Openbox:_Control_Speaker_Volume_Using_the_Keyboard_(ALSA)
imported>Dalto
m (Dalto moved page Openbox: Control Screen Brightness Using the Keyboard to Openbox: Merging openbox articles)
imported>Dalto
(Generalized and merged content from Openbox:_Control_Speaker_Volume_Using_the_Keyboard_(ALSA))
Line 1: Line 1:
=Overview=
__TOC__


The Openbox Window Manager is designed to be highly configurable and customisable. This includes the ability to create your own custom '''keybindings'''. These are combinations of key presses that may be used to undertake virtually any action, usually much faster and more directly than other means, such as by sifting through a menu. This includes the ability to create keybindings that can be used to manually control the brightness of your screen.


Although the Manjaro Openbox flavour provides a user-friendly graphical interface that may be used to alter or create custom keybindings, as the intention is to bind control of the screen brightness to the actual keys designed for this purpose, in this instance it will be necessary to manually edit the Openbox '''rc.xml''' file. This file - amongst other essential functions - serves to store and enable keybindings in the Openbox environment.
=Overview=


The [http://openbox.org/wiki/Main_Page Openbox Window Manager] is designed to be highly configurable and customisable with extensive standards support.


=Step 1: Opening the ''rc.xml'' File=


{{Note|It is not necessary to use the 'sudo' or 'gksu' commands, as you already have full permission to edit and amend the ''rc.xml'' file. It is also strongly recommended to use a text editor to amend the file, as it is quite large, and they provide search functions.}}
=Installing Openbox=


For information on how to install basic Openbox environment please review the [[Install_Desktop_Environments#Openbox Openbox installation instructions]].


You will need to first open your terminal in order to edit the ''rc.xml'' file. The syntax of the command to edit this is:


[text editor] ~/.config/openbox/rc.xml
=Adjusting Keybindings for Special Keys=


Openbox is built to be customized, this includes the ability to create your own custom '''keybindings'''. These are combinations of key presses that may be used to undertake virtually any action, usually much faster and more directly than other means, such as by sifting through a menu. Although the Manjaro Openbox Edition provides a user-friendly graphical interface that may be used to alter or create custom keybindings, some combinations of special keys are not easily managed through this interface.


For example, if you wish to edit the file within the terminal using nano (a standard terminal-based text editor) then enter:
nano ~/.config/openbox/rc.xml
Otherwise - if you have installed the full version of Manjaro (i.e. not the NET-Edition) - you may find it easier to use a text editor like Gedit or Leafpad instead. This will create and open the ''rc.xml'' file up as a document, making it easier to read and edit. To use Gedit instead, the command is:
gedit ~/.config/openbox/rc.xml
=Step 2: Editing the ''rc.xml'' file=
{{tip|If you know what you are doing, then feel free to change the intended keys. Just ensure that they are not already being used for another purpose.}}


In this instance it will be necessary to manually edit the Openbox {{ic|rc.xml}} file. One of the many functions of this file is to store and enable keybindings in the Openbox environment.  This file is located at {{ic|~/.config/openbox/rc.xml}} and you can edit it with a standard [[Viewing_and_editing_configuration_files|text editor]].


==Screen Brightness==
Once the file has been opened, you will be presented with a substantial amount of commands contained within it. Don't worry about this, as you will only need to add a new block of code, rather than amend anything that is there. The code that must be added to enable full manual control over the screen brightness is as follows:
Once the file has been opened, you will be presented with a substantial amount of commands contained within it. Don't worry about this, as you will only need to add a new block of code, rather than amend anything that is there. The code that must be added to enable full manual control over the screen brightness is as follows:


Line 47: Line 36:




To find the correct place in order to insert the above commands, it is recommended to use the ''find'' or ''Search'' functions provided by Gedit or Leafpad. Otherwise - if using nano - it will be necessary to manually scroll down to about the mid-way point (perhaps using the ''Page-Down'' key) to locate the following code:
To find the correct place in order to insert the above commands, it is recommended to use the '''Find''' or '''Search''' functions provided by your editor. If your text editor does not have the ability to search, it will be necessary to manually scroll down to about the mid-way point (perhaps using the '''Page Down''' key) to locate the following code:


  </keyboard>
  </keyboard>
Line 55: Line 44:


     </keybind>
     </keybind>
  '''</keyboard>'''
    </keyboard>
   <mouse>
   <mouse>


Line 80: Line 69:
* `xbacklight -get` to see if the minimum value has been reached.
* `xbacklight -get` to see if the minimum value has been reached.


Once you have made the necessary amendments to the file, save the changes and close it by:
Once you have made the necessary amendments to the file, save the changes and close it.


* '''nano''': Press CTRL and 'x' to exit, 'y' to save, and <enter> to finish, or
 
* '''Gedit or Leafpad''': Select the 'save' option and then close the window.
Now logout and back in again for the changes to take effect.
 
 
==Volume Keys (ALSA)==
 
Once the file has been opened, you will be presented with a substantial amount of commands contained within it. Don't worry about this, as you will only need to add a new block of code, rather than amend anything that is there. The code that must be added to enable full manual control over the volume (i.e. to raise, lower, and mute it) is as follows:
 
    <keybind key="XF86AudioRaiseVolume">
      <action name="Execute">
        <command>amixer set Master 10%+</command>
      </action>
  </keybind>
    <keybind key="XF86AudioLowerVolume">
      <action name="Execute">
        <command>amixer set Master 10%-</command>
      </action>
    </keybind>
    <keybind key="XF86AudioMute">
      <action name="Execute">
        <command>amixer set Master toggle</command>
      </action>
  </keybind>
 
{{warning|This code cannot just be placed anywhere in the file. It must be placed in a particular section in order to work. Please follow the instructions below to do so.}}
 
 
To find the correct place in order to insert the above commands, it is recommended to use the '''Find''' or '''Search''' functions provided by your editor. If your text editor does not have the ability to search, it will be necessary to manually scroll down to about the mid-way point (perhaps using the '''Page Down''' key) to locate the following code:
</keyboard>
 
 
The overall section of the code should look like this:
 
    </keybind>
    </keyboard>
  <mouse>
 
 
Once located, the new code above can be inserted between the </keybind> and </keyboard> codes. Press <enter> after the </keybind> code to provide a space to do so. Below is an example where this has taken place. The new code inserted has been <font color="green">'''highlighted in green'''</font color> for illustrative purposes:
 
    </keybind>
<font color="green">    <keybind key="XF86AudioRaiseVolume"></font color>
<font color="green">      <action name="Execute"> </font color>
<font color="green">        <command>amixer set Master 10%+</command></font color>
<font color="green">      </action></font color>
<font color="green">  </keybind></font color>
<font color="green">    <keybind key="XF86AudioLowerVolume"></font color>
<font color="green">    <action name="Execute"></font color>
<font color="green">        <command>amixer set Master 10%-</command></font color>
<font color="green">      </action></font color>
<font color="green">    </keybind></font color>
<font color="green">    <keybind key="XF86AudioMute"></font color>
<font color="green">      <action name="Execute"> </font color>
<font color="green">        <command>amixer set Master toggle</command></font color>
<font color="green">      </action></font color>
<font color="green">  </keybind></font color>
  </keyboard>
  <mouse>




'''Now logout and back in again for the changes to take effect.'''
Once you have made the necessary amendments to the file, save the changes and close it.




[[Category:Contents Page]]
[[Category:Contents Page]]
Anonymous user