KShutdown - README

Visit KShutdown Home Page and Wiki for more info.

Table of Contents

KDE 4 Build vs. Qt 4 Build

KDE 4 Build Qt 4 Build
Summary A KShutdown version compiled using KDE4 libraries (super integration with KDE platform + extra features) A KShutdown version compiled without KDE4 libraries (Qt only, for Xfce, GNOME, etc.)
Compilation Script ./Setup-kde4.sh ./Setup-qt4.sh
Required Libraries libqtgui4, libqt4-dbus,
libkworkspace4, base KDE libraries		 libqtgui4, libqt4-dbus
Menu Shortcut Name KShutdown KShutdown/Qt
Default Program Location (after "make install") /usr/bin/kshutdown /usr/bin/kshutdown-qt
Dev Info
C++ #define KS_NATIVE_KDE KS_PURE_QT
Build System CMake (CMakeLists.txt files) QMake (src/src.pro file)
Language Translation System (input: po/*.po) Gettext (output: build.tmp/po/*.mo) Gettext (output: src/i18n/*.qm), kshutdown.qrc

See Supported Functions/Platforms table for more info.

KDE 4 Build @ Linux

Minimal Requirements

  1. KDE 4.4+
  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"
  4. Clang support (an alternative C++ compiler):

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 (alternative method; for geeks and nerds 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 Qt 4 Build 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
  3. Clang support (an alternative C++ compiler):
    1. cd src; qmake -spec /usr/share/qt4/mkspecs/unsupported/linux-clang/
    2. make

Qt 4 Build @ Windows

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

Minimal Requirements (for compilation)

  1. MinGW - Minimalist GNU for Windows
  2. Qt libraries for Windows (minGW, LGPL version) 4.6 or newer
  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 Waiting for a selected application Inactivity Monitor
Legend
TESTShould work, still testing ;)
OKDone (hover an item to display implementation details)
N/AFunction is not available on this platform/KShutdown version
TODO/FIXMEWork In Progress - to be implemented in a future...
CLIFunction available via Command Line (example: kshutdown --lock)
WindowsMicrosoft Windows XP/Vista/7 or compatible
*KDE 4 Build not supported
**D-Bus commands should work with GDM, KDM, and LightDM
KDE 4 (KDE 4 Build)
OK OK OK OK OK OK OK OK, no CLI OK
Windows (Qt 4 Build) *
OK OK OK OK OK OK N/A TODO OK
Xfce 4.8 (Qt 4 Build) *
OK OK OK OK OK FIXME N/A OK, no CLI TODO
LXDE (Qt 4 Build) *
OK OK OK OK OK OK N/A OK, no CLI TODO
KDE 4 (Qt 4 Build)
TEST TEST OK OK OK TODO N/A OK, no CLI OK
GNOME 3 (Qt 4 Build) *
TEST TEST OK OK OK OK N/A OK, no CLI TODO
Unity (Qt 4 Build) *
TEST TEST OK OK OK OK N/A OK, no CLI TODO
Enlightenment (Qt 4 Build) *
TEST TEST OK OK OK OK N/A OK, no CLI TODO
Razor-qt (Qt 4 Build) *
TEST TEST TEST TEST TODO TODO N/A TEST TODO
Openbox (Qt 4 Build) *
TODO (?)
GNOME 2 (Qt 4 Build) *
TODO (?)
Mac OS X (Qt 4 Build) *
TODO (?)
Haiku (Qt 4 Build) *
TODO (?)
KDE 3 (Qt 4 Build) *
TODO (?); KShutDown 1.0.x exists but it's outdated and not supported...

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