https://github.com/kde/liquidshell

Basic desktop shell using QtWidgets
https://github.com/kde/liquidshell

Last synced: 3 days ago
JSON representation

Basic desktop shell using QtWidgets

• Host: GitHub
• URL: https://github.com/kde/liquidshell
• Owner: KDE
• License: gpl-3.0
• Created: 2017-10-29T07:17:36.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-24T02:45:24.000Z (7 months ago)
• Last Synced: 2024-05-01T12:02:04.624Z (7 months ago)
• Language: C++
• Homepage: https://invent.kde.org/system/liquidshell
• Size: 1.69 MB
• Stars: 68
• Watchers: 11
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • License: COPYING

Awesome Lists containing this project

README

        
Author: Martin Koller, [email protected]

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