/oblogout-fork

ConsoleKit && UPower backend and support for multiple monitors

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

 Crunchbang Openbox Logout
   - GTK/Cairo based logout box styled for Crunchbang

    oblogout by:
      Andrew Williams <andy@tensixtyone.com>

    Originally based on code by:
       adcomp <david.madbox@gmail.com>
       iggykoopa <etrombly@yahoo.com>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

######

 INSTALLATION

 - Run ./setup.py install
 - Customise the config (/etc/oblogout.conf) as required

######

 RUN

 - Run via the 'oblogout' command

 - CAIRO RENDERING IS ONLY ENABLED FOR COMPOSITED SCREENS!
   Rendered effects are used for ones without.

######

 CONFIGURATION OPTIONS

 SETTINGS

 - Backend  = Choose backend to use with oblogout's shutdown/restart operations
      - HAL
      - ConsoleKit ( Uses UPower for suspend/hibernate )

 - Monitor  = Specify which monitor oblogout will appear in.

 LOOKS

 - Opacity = Opacity percentage of Cario rendered backgrounds
 - Bgcolor = Colour name or hex code (#ffffff) of the background color

 - Buttontheme = Icon theme for the buttons, must be in the themes folder of the
                 package, or in ~/.themes/<name>/oblogout/
 - Buttons = List and order of buttons to show

 BUTTONS

 - cancel      = Cancel logout/shutdown
 - restart     = Restart
 - shutdown    = Shutdown
 - suspend     = Suspend
 - hibernate   = Hibernate
 - safesuspend = Suspend/Hibernate mix, writes Hibernate file then suspends
 - lock        = Lock session
 - switch      = Switch user

 SHORTCUTS

 - For each button type, define a key to use. Case insenstive.

 COMMANDS

 - Same as the buttons, define a command per button type