KShutdown - README

Visit KShutdown Home Page and Wiki for more info.

Table of Contents

KDE 4 Build @ Linux

Minimal Requirements

  1. KDE 4.4+, KDM (KDE Display Manager)
  2. Qt 4.6+

Compilation & Installation

  1. Additional requirements: installed "kdelibs-dev" package, CMake 2.4, and Gettext Utilities
  2. To compile and install KShutdown run: ./Setup-kde4.sh
  3. To change the installation directory (prefix) run: ./Setup-kde4.sh "/your/prefix/dir"

Common Errors

CMake Error at /usr/share/cmake-2.6/Modules/FindKDE4.cmake:72

CMake Error at /usr/share/cmake-2.6/Modules/FindKDE4.cmake:72 (MESSAGE):
ERROR: cmake/modules/FindKDE4Internal.cmake not found in
...;/usr/lib/kde4/share/kde4/apps

Install "kdelibs-dev" (sometimes called kdelibs5-dev) and "kdebase-workspace-dev" packages for your KDE version.

CMake Error at (...) Phonon library or includes NOT found!

This may happed after Ubuntu upgrade even if required Phonon files are already installed. [Solution]

"pushd: not found" error

Try to run ./Setup-kde4.sh and cd build.tmp; sudo make install instead of sudo sh Setup-kde4.sh

Compilation & Installation (alternate method; for Geeks only)

BUILDTYPE can be Release or Debug. You can change the installation directory (prefix) by setting the CMAKE_INSTALL_PREFIX environment variable. To display default prefix for KDE 4 applications, run kde4-config --prefix.

  1. Create output directory: mkdir build && cd build
  2. Generate Makefiles: cmake -DCMAKE_BUILD_TYPE=BUILDTYPE -DCMAKE_INSTALL_PREFIX="/usr/local" ..
  3. Compile: make
  4. Make coffee
  5. Install: make install

Qt 4 Build @ Linux

Note: Some functions may be unavailable in this build. See Qt4 @ table for more info.

Minimal Requirements

  1. Qt 4.6+ (KDE libraries are not required)

Compilation & Installation

  1. To compile KShutdown run: ./Setup-qt4.sh
  2. Installation is not required

Qt 4 Build @ Windows

Note: You can download a binary (already compiled) KShutdown version for Windows.

Minimal Requirements (for compilation)

  1. Qt SDK: Complete Development Environment (Open Source, LGPL version) 4.6+
  2. MinGW (included in Qt SDK)
  3. Nullsoft Scriptable Install System (NSIS)
  4. Windows XP/Vista/7 or compatible (including Wine)

Compilation & Installation

  1. To compile and install KShutdown run: Setup-qt4.bat (this will build both portable and installable version)
  2. Experimental: To compile KShutdown under Wine/Linux run: ./Setup-wine.sh

Supported Functions/Platforms

Turn Off Computer Restart Computer Suspend Hibernate Lock Screen Logout Extras User Inactivity Monitor
Legend
OK
[TODO - implementation details]		Done.
N/AFunction is not available on this platform/KShutdown version
WIPWork In Progress - to be implemented in a future...
GUIFunction is available in main window (example: menu item, combo box entry, etc.)
CLICommand Line Interface (example: kshutdown --lock)
GDMGNOME Display Manager
KDMKDE Display Manager
WinMicrosoft Windows XP/Vista/7 or compatible
Build @ PlatformQt4 Build - a KShutdown version compiled without KDE4 libraries (Qt only)
KDE4 Build - a KShutdown version compiled using KDE4 libraries (better KDE integration + extra features)
Platform - a desktop environment or operating system name
KDE4 @ KDE4/KDM (GUI) OK OK OK OK OK OK OK OK
KDE4 @ KDE4/KDM (CLI) OK OK OK OK OK OK OK N/A
Qt4 @ Win (GUI) OK OK OK OK OK OK N/A OK
Qt4 @ Win (CLI) OK OK OK OK OK OK N/A N/A
KDE3 N/A - use older KShutdown 1.0.x
KDE4 @ Win N/A - see Qt4 @ Win
KDE4 @ Xfce/GDM WIP WIP OK OK OK OK OK N/A
Qt4 @ Xfce/GDM WIP WIP OK OK OK OK N/A N/A
KDE4 @ GNOME/GDM WIP WIP OK OK OK OK WIP WIP
Qt4 @ GNOME/GDM WIP WIP OK OK OK OK N/A WIP
Qt4 @ KDE4 WIP WIP OK WIP OK WIP N/A WIP
KDE4 @ KDE4/GDM (GUI) WIP WIP OK WIP OK OK OK OK

Compatibility with old KShutdown 1.0.x

Some configuration and command line options in KShutdown 2.x may be not fully compatible with the old KShutdown 1.0.x.

© Konrad Twardowski