Plasma: Difference between revisions

Latest revision as of 00:28, 21 December 2022

At A Glance

Plasma is the KDE workspace. Actually it is a technology that can adapt to many types of devices. Currently there are two varieties of Plasma: The Plasma Desktop environment which is the focus of the majority of our pages and Plasma Mobile, the new cool environment for pads and smartphones. The Plasma Netbook environment was removed in KDE Plasma 5 and replaced with the Application Dashboard menu.

A typical Plasma desktop looks like this:

The four key components of a default Plasma desktop are:

The panel, sometimes referred to as "the task bar", it provides room for the application launcher, the list of windows (programs), clock and system tray;
The desktop, the area where widgets and icons reside;
The folder view, a widget that lists the content of a folder on your computer, giving you quick access to basic file management tasks;
The Plasma toolbox This is located at the top left of the screen as well as at end of the panel. These are used to access configuration and other options quickly and reliably.

All of these default items are fully configurable and can host a wide variety of tools and content.

The Plasma Desktop FAQ

A "Frequent Asked Questions" for the current version of the Plasma Desktop is maintained on this page. It provides succinct answers to common questions as well as links to FAQs for older versions.

Finding your way around Plasma

You can use Plasma as you would use the desktop of any other operating system, by accessing the application launcher, viewing the currently active programs on the taskbar, accessing icons on the system tray, and so on.

An important part of Plasma are the "widgets". Widgets are the individual units of the desktop and they include (although they are not limited to) the application menu, icons, the system tray, the clock, etc. Widgets can exist on the desktop itself, or be inserted into the panel, on the screen saver or on the dashboard among other places. Widgets exist for a large number of tasks besides usual desktop helpers, including microblogging (Twitter, identi.ca), unit conversion calculators, weather forecasts, file sharing and much more. Panels and desktops are also special kinds of widgets themselves, meant to contain other widgets.

How does that relate with desktop usage? Plasma has some new features with respect to traditional desktop usage. We have already mentioned the Plasma toolboxes: those are the way to start interacting and customizing your Plasma Desktop. By clicking on them, a menu will pop up on the screen with a variety of choices: from there you can add widgets to your panel or desktop, resize, add or remove panels, change the wallpaper and other operations.

Folder Views

As you may notice in the screenshot above, there are no icons placed directly on the desktop. Instead, they are placed inside a container called a "Folder View". By default, the Folder View shows the Desktop folder and allows you to drag files to it, open them, cut, copy, paste, rename files and also create new folders/files.

You can have more than one Folder View on the desktop, and they can also be placed in panels. You can set Folder View to show any folder, local or remote, you have access to. Each Folder View can be moved and resized independently to your preference.

Folder View can also be set as the default full-screen desktop background for a more traditional "icons scattered on the desktop" layout.

Panels

Panels allow you to place widgets around the edges of the screen. These collections of widgets can be configured in various ways, including making them automatically hide when not in use or aligned to certain areas of the screen.

By default, there is one panel at the bottom of the screen, but you can add more panels, move and otherwise configure the default panel and remove panels you no longer want. The widgets in all of the panels may also be adjusted to your liking.

For more information on configuring panels in Plasma Desktop and what they are capable of doing for you, visit the Plasma Panels page.

Latte Dock is an alternative panel.

Widgets

Plasma supports widgets written specifically for Plasma (also known as Plasmoids) as well as widgets from other sources such as Google Gadgets, Superkaramba and some Dashboard Widgets from Mac OSX. Additional widgets can easily be found and installed through Get Hot New Stuff.

To see the widgets that are installed on your system and ready to use open the Plasma Widget Explorer by either

opening the Desktop Toolbox in the upper right corner of the screen and selecting Add Widgets,
opening the Panel Toolbox furthest to the right in the Panel and selecting Add Widgets, or
right clicking on the Desktop and choosing Add Widgets from the context menu.

To place a widget on the Desktop simply drag it from the Widget Explorer to the Desktop. To place a widget in the panel first open the Panel Toolbox and from there open the Widget Explorer (click Add Widgets), locate the widget you wish to add and drag it to the desired position in the Panel.

Note

You can not add widgets if they are locked. Open the Desktop Toolbox or the Panel Toolbox or right click on the Desktop - if you see an item labeled Unlock Widgets then select that, and then proceed to add widgets to your Desktop or your Panel.

When you are done adding widgets you might want to lock widgets again: Open a Toolbox or the Desktop context menu and click Lock Widgets.

Widgets that are docked into a panel usually have an Options menu, while those on the desktop have the configuration options within the 'handle', the shaded area which pops up when hovering over the widget. Clicking and holding the mouse on the blank part of the handle will allow you to drag the widget to the desired position.

You have four tools on this handle. The top one is the re-sizer. Click and drag on the tool to resize the widget.

The second tool is a rotate tool. Again, click and hold the tool, while rotating to the desired angle.

The third is the wrench or spanner which allows you to configure that particular widget's settings.

Finally, the fourth tool is the "expanded view" tool and is available only on widgets that support this feature, such as the Picture Frame or Web viewers. When clicked, the Picture Frame widget will, for example, open the currently viewed in an image viewer while the Web Slice widget will open the web page in a full web browser window.

A list of Plasma widgets with their own page can be found here, and some of our favourite widgets are discussed on the Plasma Widgets page

Activities

The icons shown in the screenshot have small buttons in the top right and bottom right. The small pause button in the top right prevents the activity from being included when switching through Activities using Super + Tab. It also opens up an "x" to delete the activity. To change the names of the activities, look for the small wrench in the bottom right of the icon.

Use Cases

A user likes web comics so they add their favorite web comics via the comics widget. The user now has a full desktop activity dedicated to their favorite web comics. Now the user is happy with the web comics, but the user now has to go to work, so the user creates an activity with the folder view widgets set to the folders of the projects the user is currently working on. After work the user goes home and works on a side project of writing romance novels. The user always gains inspiration by looking at pictures of the user's significant other. The user now creates a new Activity but now puts pictures frame widgets with pictures of the user's significant other. The user also has a folder view of the romance novel project folder. Now no matter what the user is doing the user has a custom tailored activity to match it.

Go to this blog to read a few tips on using activities. Chanis blog has a number of examples as well as screencasts about activities.

Widget Layouts and Virtual Desktops

Virtual desktops, the ability to have a separate sets of windows on separate desktops, can tie in with Activities. You can have a different activity on each virtual desktop. In Plasma Desktop 4.4, this can be configured by entering System Settings and navigating to Desktop -> Multiple Desktops, and checking Different Activity for Each Desktop.

In Plasma Desktop 4.3, You configure this by zooming out and choosing configure Plasma. Then select use a different activity on each desktop and zoom in again.

Hints and Tips

There is subpage Plasma/Tips enumerating a lot of useful tips for Plasma.

Tweaking Plasma

Learn how to add a sidebar with clock and news.

Customize your Plasma by mixing multiple Plasma themes.

Learn how to create a look and feel package.

Learn how to create a Unity-like look and feel theme using Plasma’s Desktop Scripting API.

Learn how to change the default Window Manager in Plasma.

Reloading Plasma

Sometimes you might want to reload Plasma, like right after changing system language so the changes takes effect, or because of a problem with the desktop. To do that, open a terminal(or KRunner) and run these commands:

kstart5 plasmashell --replace

More Information

The Plasma FAQ's
Plasma HowTo's - short screencasts
Glossary
Some of our favourite plamoids - why not add yours?
Here's how to install more Plasmas widgets
Learn the versatility of KRunner

Back to the Introduction page

@@ Line 3: / Line 3: @@
 == At A Glance == <!--T:4-->
+<!--T:85-->
+Plasma is the KDE workspace. Actually it is a technology that can adapt to many types of devices. Currently there are two varieties of Plasma: The Plasma Desktop environment which is the focus of the majority of our pages and Plasma Mobile, the new cool  environment for pads and smartphones. The [[Special:myLanguage/Plasma/Netbooks|Plasma Netbook]] environment was removed in KDE Plasma 5 and replaced with the Application Dashboard menu.
 <!--T:5-->
@@ Line 8: / Line 11: @@
 <!--T:6-->
-[[Image:KDESC_Default_Desktop.png|512px|center]]
+[[Image:Plasma_Desktop.png|600px|center]]
 <!--T:7-->
@@ Line 14: / Line 17: @@
 <!--T:8-->
-* '''The [[Plasma/Panels|panel]]''', sometimes referred to as "the task bar", it provides room for the application launcher, the list of windows (programs), clock and system tray;
+* '''The [[Special:myLanguage/Plasma/Panels|panel]]''', sometimes referred to as "the task bar", it provides room for the application launcher, the list of windows (programs), clock and system tray;
 * '''The desktop''', the area where widgets and icons reside;
-* '''The [[Plasma/FolderView|folder view]]''', a widget that lists the content of a folder on your computer, giving you quick access to basic file management tasks;
+* '''The [[Special:myLanguage/Plasma#Folder_Views|folder view]]''', a widget that lists the content of a folder on your computer, giving you quick access to basic file management tasks;
-* '''The Plasma toolbox''' This is located at the top right of the screen as well as at end of the panel. These are used to access configuration and other options quickly and reliably.
+* '''The Plasma toolbox''' This is located at the top left of the screen as well as at end of the panel. These are used to access configuration and other options quickly and reliably.
 <!--T:71-->
@@ Line 25: / Line 28: @@
 <!--T:72-->
-A "Frequent Asked Questions" for the current version of the Plasma Desktop is maintained [[Special:mylanguage/Plasma/FAQ | on this page]]. It provides succinct answers to common questions as well as links to FAQs for older versions.
+A "Frequent Asked Questions" for the current version of the Plasma Desktop is maintained [[Special:mylanguage/Plasma/FAQ/Index | on this page]]. It provides succinct answers to common questions as well as links to FAQs for older versions.
 === Finding your way around Plasma === <!--T:9-->
 <!--T:10-->
-You can use Plasma as you would use the desktop of any other operating system, by accessing the [[Plasma/Kickoff|application launcher]], viewing the currently active programs on the [[Plasma/Tasks|taskbar]], accessing icons on the [[Plasma/SystemTray|system tray]], and so on.
+You can use Plasma as you would use the desktop of any other operating system, by accessing the [[Special:myLanguage/Plasma/Kickoff|application launcher]], viewing the currently active programs on the [[Special:myLanguage/Plasma/Tasks|taskbar]], accessing icons on the system tray, and so on.
 <!--T:11-->
-An important part of Plasma are the "widgets". Widgets are the individual units of the desktop and they include (although they are not limited to) the application menu, icons, the system tray, the clock, etc. Widgets can exist on the desktop itself, or be inserted into the panel, on the screen saver or on the [[Plasma/DesktopDashboard|dashboard]] among other places. Widgets exist for a large number of tasks besides usual desktop helpers, including microblogging (Twitter, identi.ca), unit conversion calculators, weather forecasts, file sharing and much more. Panels and desktops are also special kinds of widgets themselves, meant to contain other widgets.
+An important part of Plasma are the "widgets". Widgets are the individual units of the desktop and they include (although they are not limited to) the application menu, icons, the system tray, the clock, etc. Widgets can exist on the desktop itself, or be inserted into the panel, on the screen saver or on the dashboard among other places. Widgets exist for a large number of tasks besides usual desktop helpers, including microblogging (Twitter, identi.ca), unit conversion calculators, weather forecasts, file sharing and much more. Panels and desktops are also special kinds of widgets themselves, meant to contain other widgets.
 <!--T:12-->
 How does that relate with desktop usage? Plasma has some new features with respect to traditional desktop usage. We have already mentioned the Plasma toolboxes: those are the way to start interacting and customizing your Plasma Desktop. By clicking on them, a menu will pop up on the screen with a variety of choices: from there you can add widgets to your panel or desktop, resize, add or remove panels, change the wallpaper and other operations.
+</translate><span id="Folder_Views"></span><translate>
 ===  Folder Views === <!--T:13-->
 <!--T:14-->
-As you may notice in the screenshot above, there are no icons placed directly on the desktop. Instead, they are placed inside a container called a "[[Plasma/FolderView|Folder View]]". By default, the Folder View shows the Desktop folder and allows you to drag files to it, open them, cut, copy, paste, rename files and also create new folders/files.
+As you may notice in the screenshot above, there are no icons placed directly on the desktop. Instead, they are placed inside a container called a "Folder View". By default, the Folder View shows the Desktop folder and allows you to drag files to it, open them, cut, copy, paste, rename files and also create new folders/files.
 <!--T:16-->
@@ Line 47: / Line 52: @@
 <!--T:73-->
-Folder View can also be set as the default full-screen desktop background for a more traditional "icons scattered on the desktop" layout. Visit the [[Plasma/FolderView|Folder View]] page to find out how to do this and much more with Folder View.
+Folder View can also be set as the default full-screen desktop background for a more traditional "icons scattered on the desktop" layout.
 === Panels === <!--T:30-->
@@ Line 58: / Line 63: @@
 <!--T:75-->
-By default, there is one panel at the bottom of the screen, but you can add more panels, move and otherwise configure the default panel and remove panels you no long want. The widgets in all of the panels may also be adjusted to your liking.
+By default, there is one panel at the bottom of the screen, but you can add more panels, move and otherwise configure the default panel and remove panels you no longer want. The widgets in all of the panels may also be adjusted to your liking.
 <!--T:76-->
-For more information on configuring panels in Plasma Desktop and what they are capable of doing for you, visit the [[Plasma/Panels|Plasma Panels]] page.
+For more information on configuring panels in Plasma Desktop and what they are capable of doing for you, visit the [[Special:myLanguage/Plasma/Panels|Plasma Panels]] page.
+<!--T:89-->
+[[Special:myLanguage/LatteDock|Latte Dock]] is an alternative panel.
 === Widgets === <!--T:18-->
+<!--T:80-->
+[[Image:WidgetsPlasma.png|thumb|150px|left|Plasma Widgets]]
 <!--T:19-->
-Plasma supports widgets written specifically for Plasma (also known as Plasmoids) as well as widgets from other sources such as Google Gadgets, Superkaramba and some Dashboard Widgets from Mac OSX. Additional widgets can easily be found and installed through [[Glossary#Get Hot New Stuff|Get Hot New Stuff]].
+Plasma supports widgets written specifically for Plasma (also known as Plasmoids) as well as widgets from other sources such as Google Gadgets, Superkaramba and some Dashboard Widgets from Mac OSX. Additional widgets can easily be found and installed through [[Special:myLanguage/Glossary#Get Hot New Stuff|Get Hot New Stuff]].
+<!--T:82-->
+To see the widgets that are installed on your system and ready to use open the Plasma Widget Explorer by either
+* opening the Desktop Toolbox in the upper right corner of the screen and selecting <menuchoice>Add Widgets</menuchoice>,
+* opening the Panel Toolbox furthest to the right in the Panel and  selecting <menuchoice>Add Widgets</menuchoice>, or
+* right clicking on the Desktop and choosing <menuchoice>Add Widgets</menuchoice> from the context menu.
+<!--T:83-->
+To place a widget on the Desktop simply drag it from the Widget Explorer to the Desktop. To place a widget in the panel first open the Panel Toolbox and from there open the Widget Explorer (click <menuchoice>Add Widgets</menuchoice>), locate the widget you wish to add and drag it to the desired position in the Panel. <br clear=all/>
+<!--T:84-->
+{{Note|1=You can not add widgets if they are locked. Open the Desktop Toolbox or the Panel Toolbox or right click on the Desktop - if you see an item labeled <menuchoice>Unlock Widgets</menuchoice> then select that, and then proceed to add widgets to your Desktop or your Panel.
+<br />
+When you are done adding widgets you might want to lock widgets again: Open a Toolbox or the Desktop context menu and click <menuchoice>Lock Widgets</menuchoice>.}}
 <!--T:20-->
@@ Line 72: / Line 97: @@
 <!--T:21-->
-[[Image:Handle.png|300px|center]]
+[[Image:Handle-new.png|300px|center]]
 <!--T:22-->
@@ Line 81: / Line 106: @@
 <!--T:24-->
-[[Image:Handle_rotate.png|300px|center]]
+[[Image:Handle-new-rotate.png|300px|center]]
@@ Line 88: / Line 113: @@
 <!--T:26-->
-Finally, the forth tool is the "expanded view" tool and is available only on widgets that support this feature, such as the Picture Frame or Web viewers. When clicked, the Picture Frame widget will, for example, open the currently viewed in an image viewer while the Web Slice widget will open the web page in a full web browser window.
+Finally, the fourth tool is the "expanded view" tool and is available only on widgets that support this feature, such as the Picture Frame or Web viewers. When clicked, the Picture Frame widget will, for example, open the currently viewed in an image viewer while the Web Slice widget will open the web page in a full web browser window.
 <!--T:27-->
-A list of Plasma widgets with their own page can be found [http://userbase.kde.org/Category:Widgets here], and some of our favourite widgets are discussed on ''[[Plasma/Plasmoids|the Plasma Widgets page]]''
+A list of Plasma widgets with their own page can be found [[Special:myLanguage/Category:Widgets|here]], and some of our favourite widgets are discussed on ''[[Special:myLanguage/Plasma/Plasmoids|the Plasma Widgets page]]''
+</translate><span id="Activities"></span><translate>
 == Activities == <!--T:49-->
+<!--T:86-->
+The icons shown in the screenshot have small buttons in the top right and bottom right. The small pause button in the top right prevents the activity from being included when switching through Activities using <keycap>Super + Tab</keycap>. It also opens up an "x" to delete the activity.  To change the names of the activities, look for the small wrench in the bottom right of the icon.
+<!--T:81-->
+[[Image:Activities-Plasma5.6.png|thumb|150px|left|Plasma Activity Explorer]]
 === Use Cases === <!--T:54-->
 <!--T:55-->
-A user likes web comics so they add their favorite web comics via the comics widget. The user now has a full desktop activity dedicated to their favorite web comics.  Now the user is happy with the web comics, but the user now has to go to work, so the user creates a activity with the folder view widgets set to the folders of the projects the user is currently working on.  After work the user goes home and works on a side project of writing romance novels.  The user always gains inspiration by looking at pictures of the user's significant other. The user now creates a new Activity but now puts pictures frame widgets with pictures of the user's significant other.  The user also has a folder view of the romance novel project folder.  Now no matter what the user is doing the user has a custom tailored activity to match it.
+A user likes web comics so they add their favorite web comics via the comics widget. The user now has a full desktop activity dedicated to their favorite web comics.  Now the user is happy with the web comics, but the user now has to go to work, so the user creates an activity with the folder view widgets set to the folders of the projects the user is currently working on.  After work the user goes home and works on a side project of writing romance novels.  The user always gains inspiration by looking at pictures of the user's significant other. The user now creates a new Activity but now puts pictures frame widgets with pictures of the user's significant other.  The user also has a folder view of the romance novel project folder.  Now no matter what the user is doing the user has a custom tailored activity to match it.
 <!--T:56-->
-Go to [http://hanswchen.wordpress.com/2009/11/17/how-do-you-use-activities/  this blog] to read a few tips on using activities.
+Go to [http://hanswchen.wordpress.com/2009/11/17/how-do-you-use-activities/  this blog] to read a few tips on using activities. [http://chani.wordpress.com/category/activities/ Chanis blog] has a number of examples as well as screencasts about activities.
 == Widget Layouts and Virtual Desktops == <!--T:51-->
 <!--T:52-->
-Virtual desktops, the ability to have a separate sets of windows on separate desktops, can tie in with Activities. You can have a different activity on each virtual desktop. In Plasma Desktop 4.4, this can be configured by entering System Settings and navigating to Desktop -> Multiple Desktops, and checking "Different Activity for Each Desktop".
+Virtual desktops, the ability to have a separate sets of windows on separate desktops, can tie in with Activities. You can have a different activity on each virtual desktop. In Plasma Desktop 4.4, this can be configured by entering <menuchoice>System Settings</menuchoice> and navigating to <menuchoice>Desktop -> Multiple Desktops</menuchoice>, and checking <menuchoice>Different Activity for Each Desktop</menuchoice>.
 <!--T:53-->
-In Plasma Desktop 4.3, You configure this by zooming out and choosing "configure Plasma". Then select "use a different activity on each desktop" and zoom in again.
+In Plasma Desktop 4.3, You configure this by zooming out and choosing <menuchoice>configure Plasma</menuchoice>. Then select <menuchoice>use a different activity on each desktop</menuchoice> and zoom in again. <br clear=all/>
 ==Hints and Tips== <!--T:57-->
-===The Taskbar=== <!--T:58-->
+<!--T:90-->
+There is subpage [[Special:myLanguage/Plasma/Tips|Plasma/Tips]] enumerating a lot of useful tips for Plasma.
+===Tweaking Plasma=== <!--T:64-->
-<!--T:59-->
+<!--T:65-->
-'''Accessing the Taskbar Settings Menu:''' Click the panel toolbox (aka cashew), then right-click on the taskbar.  From there you can access the Taskbar Settings dialog.  The following settings are particularly useful:
+* Learn how to [[Special:myLanguage/Plasma/TweakingPlasma#A_Windows_Vista-like_sidebar_with_clock_and_news|add a sidebar with clock and news]].
-<!--T:60-->
+<!--T:66-->
-:'''Grouping and Sorting:''' Grouping can be by program name, manually, or not at all.  (You can also choose to only enable grouping if the taskbar is full.)  Similarly, Sorting defaults to alphabetically, but it can also be by desktop, manually, or not sorted.
+* Customize your Plasma by [[Special:myLanguage/Plasma/TweakingPlasma#Using_Multiple_Plasma_Themes|mixing multiple Plasma themes]].
-<!--T:61-->
+<!--T:87-->
-:'''Only Show Tasks from the Current Desktop:''' A checkbox on the Filters section.
+* Learn how to [[Special:myLanguage/Plasma/Create_a_Look_and_Feel_Package | create a look and feel package]].
-<!--T:62-->
+<!--T:88-->
-:'''Have More than One Row on the Taskbar:''' If you use many applications at one time you may find it advantageous to set Maximum Rows and then Force Row Settings.
+* Learn how to [[Special:myLanguage/Plasma/How to create a Unity-like look and feel theme using Plasma’s Desktop Scripting API|create a Unity-like look and feel theme using Plasma’s Desktop Scripting API]].
-<!--T:63-->
+<!--T:91-->
-:'''Showing or Hiding Tooltips:''' A simple checkbox in the Appearance section of the General page.
+* Learn how to [[Special:myLanguage/Tutorials/Using_Other_Window_Managers_with_Plasma|change the default Window Manager in Plasma]].
-===Tweaking Plasma=== <!--T:64-->
+===Reloading Plasma=== <!--T:77-->
-<!--T:65-->
+<!--T:78-->
-:Learn how to [[Plasma/TweakingPlasma#A_Windows_Vista-like_sidebar_with_clock_and_news|add a sidebar with clock and news]]
+Sometimes you might want to reload Plasma, like right after changing system language so the changes takes effect, or because of a problem with the desktop. To do that, open a terminal(or [[Special:myLanguage/Plasma/Krunner|KRunner]]) and run these commands:
-<!--T:66-->
+<!--T:79-->
-:Customize your Plasma by [[Plasma/TweakingPlasma#Using_Multiple_Plasma_Themes|mixing multiple Plasma themes]]
+{{Input|1=kstart5 plasmashell --replace}}
-== Further information == <!--T:67-->
+== More Information == <!--T:67-->
 <!--T:68-->
-* [[Plasma/FAQ | The Plasma FAQ]]
+* [[Special:myLanguage/Plasma/FAQ/Index | The Plasma FAQ's]]
-* [[Plasma/HowTo | Plasma HowTo - short screencasts]]
+* [[Special:myLanguage/Plasma/HowTo/Index | Plasma HowTo's - short screencasts]]
-* [[Glossary | Glossary]]
+* [[Special:myLanguage/Glossary | Glossary]]
-* [[Plasma/Plasmoids| Some of our favourite plamoids]] - why not add yours?
+* [[Special:myLanguage/Plasma/Plasmoids| Some of our favourite plamoids]] - why not add yours?
-* [[Plasma/Installing Plasmoids|Here's how to install more Plasmas widgets]]
+* [[Special:myLanguage/Plasma/Installing Plasmoids|Here's how to install more Plasmas widgets]]
-* [[Plasma/Krunner|Learn the versatility of KRunner]]
+* [[Special:myLanguage/Plasma/Krunner|Learn the versatility of KRunner]]
 <!--T:69-->
 {|style="text-align:right"
-|'''Back to [[An_introduction_to_KDE|the Introduction page''']]
+|'''Back to [[Special:myLanguage/An_introduction_to_KDE|the Introduction page''']]
 |}
 <!--T:70-->
-[[Category:Desktop]]
 [[Category:Plasma]]
 </translate>