shift-shell/containments/homescreens/folio
Marco Allegretti a0bad0507f Add virtual desktop pager to convergence dock
Show compact numbered desktop buttons in the dock bar when two or
more virtual desktops exist. The buttons are split symmetrically
to the left and right of the centred app-icon cluster, matching
Plasma Desktop pager behaviour.

Click a button to switch desktops. Drag a running-task icon from
the dock and release it over a desktop button to move that window
to the target desktop. Right-click a task icon for a "Move to …"
submenu when the pager is visible.

The feature is a no-op on single-desktop sessions.
2026-05-04 11:43:41 +02:00
..
qml Add virtual desktop pager to convergence dock 2026-05-04 11:43:41 +02:00
applicationlistmodel.cpp Fix app list model filter ordering and reset handling 2026-04-18 19:05:04 +02:00
applicationlistmodel.h Add category filter panel to the app drawer 2026-04-18 13:20:13 +02:00
CMakeLists.txt Add task panel to Folio drawer 2026-04-29 12:10:31 +02:00
delegatetoucharea.cpp Add drag-reorder for dock favourites 2026-04-12 14:15:13 +02:00
delegatetoucharea.h Add drag-reorder for dock favourites 2026-04-12 14:15:13 +02:00
dragstate.cpp folio: Fix delegate drop placement not accounting for view padding 2026-01-13 21:57:13 -05:00
dragstate.h folio: Refactor and implement support for proper drag & drop 2025-12-13 21:24:05 -05:00
favouritesmodel.cpp Fix homescreen includes, accessibility, and popup clamp 2026-04-18 20:25:05 +02:00
favouritesmodel.h Allow dragging running dock tasks to pin them 2026-04-13 12:32:54 +02:00
folioapplication.cpp Add category filter panel to the app drawer 2026-04-18 13:20:13 +02:00
folioapplication.h Add category filter panel to the app drawer 2026-04-18 13:20:13 +02:00
folioapplicationfolder.cpp homescreens/folio: Do not initialize shared_ptr with a QObject parent 2025-07-15 18:10:03 -04:00
folioapplicationfolder.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
foliodelegate.cpp homescreens/folio: Do not initialize shared_ptr with a QObject parent 2025-07-15 18:10:03 -04:00
foliodelegate.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
foliosettings.cpp folio: Move settings to config group, and consolidate 2025-07-16 15:44:59 -04:00
foliosettings.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
foliowidget.cpp homescreens/folio: Do not initialize shared_ptr with a QObject parent 2025-07-15 18:10:03 -04:00
foliowidget.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
homescreen.cpp Add task panel to Folio drawer 2026-04-29 12:10:31 +02:00
homescreen.h Add task panel to Folio drawer 2026-04-29 12:10:31 +02:00
homescreenstate.cpp folio: Refactor and implement support for proper drag & drop 2025-12-13 21:24:05 -05:00
homescreenstate.h folio: Refactor and implement support for proper drag & drop 2025-12-13 21:24:05 -05:00
Messages.sh homescreens/folio: Fix translations id 2023-11-05 11:45:36 -08:00
metadata.json SVN_SILENT made messages (.desktop file) - always resolve ours 2026-03-15 01:41:15 +00:00
pagelistmodel.cpp folio: Move settings to config group, and consolidate 2025-07-16 15:44:59 -04:00
pagelistmodel.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
pagemodel.cpp folio: Delete delegates if the application is removed 2025-03-19 23:40:11 -04:00
pagemodel.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
README.md Proofreading 2024-06-17 00:02:08 +03:00
widgetcontainer.cpp homescreens/folio: Block propagation if edit mode is active to avoid widget to trigger event 2025-06-18 05:53:15 -04:00
widgetcontainer.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
widgetsmanager.cpp homescreens/folio: Port away from singletons to support multi-display 2024-06-22 19:11:04 -04:00
widgetsmanager.h homescreens/folio: Port away from singletons to support multi-display 2024-06-22 19:11:04 -04:00
windowlistener.cpp folio: Rewrite 2023-10-22 04:08:28 +00:00
windowlistener.h folio: Rewrite 2023-10-22 04:08:28 +00:00

Folio Homescreen

This is the paged homescreen for Plasma Mobile.

How it works

Most of the homescreen is in C++ in order to keep logic together, with QML only responsible for the display and user input.

As such, all the positioning and placement of delegates on the screen are top down from the model, as well as drag and drop behaviour.

TODO

  • BUG: If an app gets uninstalled, the homescreen UI needs to ensure that delegates are updated
  • BUG: landscape favourites bar duplication when dragging icon from it sometimes
  • BUG: can't insert delegates in-between very well in landscape favourites bar
  • BUG: drag and drop animation when rejected on a different page
  • IMPROVEMENT: can make the touch area only the icon?
  • FEATURE: Add folio/halcyon switcher in initial-start
  • FEATURE: add widget import/export
  • FEATURE: keyboard navigation
  • FEATURE: touchpad navigation
  • FEATURE: option to darken wallpaper
  • FEATURE: option to turn off row/column swap
  • PERFORMANCE: ensure that the widget config overlays are in loaders