Manjaro Difference between revisions of "Openbox"

Difference between revisions of "Openbox"

From Manjaro
imported>Dalto
m (Dalto moved page Openbox: Control Screen Brightness Using the Keyboard to Openbox: Merging openbox articles)
(Marked this version for translation)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
=Overview=
<languages/>
__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.
<translate>
=Overview= <!--T:1-->


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.
<!--T:2-->
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=
<!--T:3-->
[[File: Openbox-wm-18.jpg|left|600px]]
<div style="clear: both"></div>


{{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= <!--T:4-->


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:
<!--T:5-->
For information on how to install a basic Openbox environment please review the [[Install_Desktop_Environments#Openbox|Openbox installation instructions]].


[text editor] ~/.config/openbox/rc.xml


=Adjusting keybindings= <!--T:6-->


For example, if you wish to edit the file within the terminal using nano (a standard terminal-based text editor) then enter:
<!--T:7-->
 
Openbox is built to be customized, and 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.
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.}}


<!--T:8-->
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]].


==Example: screen brightness== <!--T:9-->
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:


     <keybind key="XF86MonBrightnessUp">
     <!--T:10-->
<keybind key="XF86MonBrightnessUp">
       <action name="Execute">
       <action name="Execute">
         <command>xbacklight +10</command>
         <command>xbacklight +10</command>
Line 44: Line 43:
     </keybind>
     </keybind>


<!--T:11-->
{{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.}}
{{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.}}


<!--T:12-->
To find the correct place 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:


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:
<!--T:13-->
 
</keyboard>
</keyboard>
 


<!--T:14-->
The overall section of the code should look like this:
The overall section of the code should look like this:


     </keybind>
     <!--T:15-->
  '''</keyboard>'''
</keybind>
    </keyboard>
   <mouse>
   <mouse>


 
<!--T:16-->
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:
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>
     <!--T:17-->
</keybind>
  <font color="green">    <keybind key="XF86MonBrightnessUp"></font color>
  <font color="green">    <keybind key="XF86MonBrightnessUp"></font color>
  <font color="green">      <action name="Execute"></font color>
  <font color="green">      <action name="Execute"></font color>
Line 75: Line 78:
   <mouse>
   <mouse>


<!--T:18-->
If the command "xbacklight +10" does nothing, find out the minimum value to put instead of 10 by trying to set the brightness to 20, then 40. You can use the following commands:
If the command "xbacklight +10" does nothing, find out the minimum value to put instead of 10 by trying to set the brightness to 20, then 40. You can use the following commands:


<!--T:19-->
* `xbacklight =X` to change the brightness, and
* `xbacklight =X` to change the brightness, and
* `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:
<!--T:20-->
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
<!--T:21-->
* '''Gedit or Leafpad''': Select the 'save' option and then close the window.
Now logout and back in again for the changes to take effect.




'''Now logout and back in again for the changes to take effect.'''
==Example: volume keys (ALSA)== <!--T:22-->
 
<!--T:23-->
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:
 
    <!--T:24-->
<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>
 
<!--T:25-->
{{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.}}
 
<!--T:26-->
To find the correct place 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>
 
<!--T:27-->
The overall section of the code should look like this:
 
    <!--T:28-->
</keybind>
    </keyboard>
  <mouse>
 
<!--T:29-->
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:
 
    <!--T:30-->
</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>


<!--T:31-->
Once you have made the necessary amendments to the file, save the changes and close it.
</translate>


[[Category:Contents Page]]
[[Category:Contents Page{{#translation:}}]]
[[Category:Editions{{#translation:}}]]

Latest revision as of 18:15, 7 September 2021

Other languages:
English • ‎русский

Overview

The Openbox Window Manager is designed to be highly configurable and customisable with extensive standards support.


Openbox-wm-18.jpg


Installing Openbox

For information on how to install a basic Openbox environment please review the Openbox installation instructions.


Adjusting keybindings

Openbox is built to be customized, and 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.

In this instance it will be necessary to manually edit the Openbox 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 ~/.config/openbox/rc.xml and you can edit it with a standard text editor.

Example: 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:

    <keybind key="XF86MonBrightnessUp">
      <action name="Execute">
        <command>xbacklight +10</command>
      </action>
    </keybind>
    <keybind key="XF86MonBrightnessDown">
      <action name="Execute"> 
        <command>xbacklight -10</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 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 highlighted in green for illustrative purposes:

    </keybind>
     <keybind key="XF86MonBrightnessUp">
       <action name="Execute">
         <command>xbacklight +10</command>
       </action>
     </keybind>
     <keybind key="XF86MonBrightnessDown">
       <action name="Execute">
         <command>xbacklight -10</command>
       </action>
    </keybind>
  </keyboard>
  <mouse>

If the command "xbacklight +10" does nothing, find out the minimum value to put instead of 10 by trying to set the brightness to 20, then 40. You can use the following commands:

  • `xbacklight =X` to change the brightness, and
  • `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.

Now logout and back in again for the changes to take effect.


Example: 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 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 highlighted in green for illustrative purposes:

    </keybind>
    <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>
  </keyboard>
  <mouse>

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

Cookies help us deliver our services. By using our services, you agree to our use of cookies.