/liquidshell

Basic desktop shell using QtWidgets

Primary LanguageC++GNU General Public License v3.0GPL-3.0

Author: Martin Koller, kollix@aon.at
First release: Oktober 2017

liquidshell is a basic Desktop Shell implemented using QtWidgets.

Main Features:
- Wallpaper per virtual desktop
- Weather, Disk Usage, Picture Frame Applets (per virtual desktop or on all)
- No animations, low memory and CPU footprint
- Instant startup
- QtWidgets based, therefore follows widget style from systemsettings
- Icons are used from your globally defined icon theme from systemsettings
- Colors are used from your globally defined color theme from systemsettings
- Can additionally be styled with css by passing the commandline option -stylesheet filename.css
  (see included example stylesheet.css)
- uses existing KDE Frameworks dialogs for most configurations, e.g. StartMenu, Virtual Desktops, Bluetooth, Network
- Just one bottom DesktopPanel, containing:
  StartMenu (allowing drag of entries into konqueror/dolphin to configure QuickLaunch or AppMenu entries)
  QuickLaunch (showing icons for .desktop files from a configurable folder)
  AppMenu (showing .desktop files in a menu from a configurable folder, defaults to users desktop folder)
  Pager (for switching virtual desktops)
  WindowList (Popup showing all open windows on all desktops)
  TaskBar (showing windows on the current desktop, allowing drag of an entry onto the Pager to move to a different desktop)
  LockLogout
  SysLoad widget including CPU, Memory, Swap and Network bars, live updated tooltip
  SysTray with integrated Network-, Notifications-, Device Notifier-, Bluetooth-, Battery- display.
      It also features PackageKit software updates integration.
      The DeviceList also shows devices connected and paired with KDEConnect.
      Display of StatusNotifier items from other applications (no legacy embedded icons yet).
      Notifications kept in a history list for some minutes, including timestamp and text selectable per mouse
      (very handy for copy/paste of TAC numbers from online banking received via SMS and transferred to KDE
       via kdeconnect)
  Clock widget (with calendar popup, tooltip for selected cities)

How to start liquidshell instead of plasmashell
-----------------------------------------------

Select "Liquidshell" from the list of possible session types on your login screen

Building from source
--------------------

mkdir build
cd build
cmake ..
make


Configuration
------------------------
To change the appearance details (beside the widget style, fonts, icon theme and color scheme
selected via the systemsettings), you can use the commandline option -stylesheet filename.css
to provide a Qt CSS widget stylesheet. For some examples see the included stylesheet.css file.
For details about the syntax and possible options see http://doc.qt.io/qt-5/stylesheet.html

#############
To explicitly disable the Software-Updater (packagekit based), set the ~/.config/liquidshellrc
config file entry:

[SoftwareUpdates]
enabled=false

The config file and a default entry will be created at first run of liquidshell

#############
To explicitly disable icons shown on the Pager buttons, set the ~/.config/liquidshellrc
config file entry:

[Pager]
showIcons=true

The config file and a default entry will be created at first run of liquidshell