LatteDock/FAQ: Difference between revisions

From KDE Wiki Sandbox
(remove deprecated questions)
(disable autocolor for specific applet)
 
(18 intermediate revisions by 2 users not shown)
Line 3: Line 3:
<!--T:1-->
<!--T:1-->
[[Special:myLanguage/LatteDock|←Latte Dock]]
[[Special:myLanguage/LatteDock|←Latte Dock]]
<!--T:143-->
[[File:LLoXdgK.png|right|Latte Dock!]]


==  What is Latte Dock? How did it begin? == <!--T:2-->
==  What is Latte Dock? How did it begin? == <!--T:2-->
Line 8: Line 11:
<!--T:3-->
<!--T:3-->
'''Latte Dock''' is a dock based on plasma frameworks and a direct successor of [https://github.com/psifidotos/nowdock-panel Now Dock]. '''Latte''' is the combined effort from the developers of [https://github.com/psifidotos/nowdock-panel Now Dock] and [https://github.com/audoban/Candil-Dock Candil Dock].
'''Latte Dock''' is a dock based on plasma frameworks and a direct successor of [https://github.com/psifidotos/nowdock-panel Now Dock]. '''Latte''' is the combined effort from the developers of [https://github.com/psifidotos/nowdock-panel Now Dock] and [https://github.com/audoban/Candil-Dock Candil Dock].
== Which Linux distros provide "Out Of The Box" Latte Dock experience? == <!--T:144-->
<!--T:145-->
* [https://nxos.org/ Nitrux]
* [https://garudalinux.org/ Garuda KDE Dragonized]
* [https://xldb.techxero.com/ Xerolinux]
* [https://distrowatch.com/table.php?distribution=bluestar Bluestar Linux]
* [https://pearos.xyz/ pearOS]


== How can I add launchers? == <!--T:4-->
== How can I add launchers? == <!--T:4-->
Line 15: Line 27:


<!--T:6-->
<!--T:6-->
You can also add them by right clicking an open window in the task manager and choosing Pin Launcher.
You can also add them outside the task manager, but this creates animation issues for sizes <64px and it is memory hungry.


== My launcher and its window are not associated correctly OR my launcher is using a low-resolution icon? == <!--T:15-->
== My launcher and its window are not associated correctly OR my launcher is using a low-resolution icon? == <!--T:15-->
Line 38: Line 50:
For instance, with "Gimp 2.10", even though its desktop file is called {{Path|1=gimp.desktop}}, its <code>StartupWMClass</code> is "gimp-2.10". <code>StartupWMClass</code> is not needed to be added for "Gimp" since plasma developers have taken special care to map it properly through {{Path|1=/etc/xdg/taskmanagerrulesrc}}.
For instance, with "Gimp 2.10", even though its desktop file is called {{Path|1=gimp.desktop}}, its <code>StartupWMClass</code> is "gimp-2.10". <code>StartupWMClass</code> is not needed to be added for "Gimp" since plasma developers have taken special care to map it properly through {{Path|1=/etc/xdg/taskmanagerrulesrc}}.


== Ok, you convinced me to try it! How can I install it and what are its dependencies? == <!--T:25-->
== How can I enable Latte Global Shortcuts? == <!--T:46-->
 
<!--T:26-->
You can download the sources, install the required dependencies and build '''Latte'''. Please read [https://invent.kde.org/plasma/latte-dock/-/blob/master/README.md README] and [https://invent.kde.org/plasma/latte-dock/-/blob/master/INSTALLATION.md INSTALLATION].
 
== How can I enable the Latte Global Shortcuts? == <!--T:46-->


<!--T:47-->
<!--T:47-->
Line 49: Line 56:


<!--T:48-->
<!--T:48-->
* <keycap>Super + No</keycap>: Activate a task</translate>
* <menuchoice>Super + Number</menuchoice> : Activate a task</translate>
<translate>
<translate>
<!--T:125-->
<!--T:125-->
* <keycap>Super + Ctrl + No</keycap>: A new instance for a task</translate>
* <menuchoice>Super + Ctrl + Number</menuchoice> : A new instance for a task</translate>
<translate>
<translate>
<!--T:126-->
<!--T:126-->
Line 59: Line 66:
== Can I use my super key to open the app launcher? == <!--T:49-->
== Can I use my super key to open the app launcher? == <!--T:49-->


<!--T:50-->
<!--T:146-->
First make sure '''Latte Dock''' is not open.
* The official way to enable this is to right click <menuchoice>Dock</menuchoice> &rarr; <menuchoice>Configure Latte...</menuchoice> &rarr; <menuchoice>Enable autostart during startup</menuchoice>
 
===Option 1:=== <!--T:51-->
Of course you can, but you will need to add at your {{Path|1=~/.config/kwinrc}} file the following code:
 
<!--T:52-->
{{Input|1=<nowiki>
[ModifierOnlyShortcuts]
Meta=org.kde.lattedock,/Latte,org.kde.LatteDock,activateLauncherMenu</nowiki>}}
 
<!--T:53-->
Then reload KWin with:
 
<!--T:54-->
{{Input|1=qdbus org.kde.KWin /KWin reconfigure}}


===Option 2:=== <!--T:55-->
<!--T:147-->
Alternatively, you can run the following commands:
* The manual way is to <menuchoice>Close Latte</menuchoice> &rarr; <menuchoice>Execute in command prompt:</menuchoice> {{Input|1=<nowiki>kwriteconfig5 --file ~/.config/kwinrc --group ModifierOnlyShortcuts --key Meta "org.kde.lattedock,/Latte,org.kde.LatteDock,activateLauncherMenu"
 
<!--T:56-->
{{Input|1=<nowiki>kwriteconfig5 --file ~/.config/kwinrc --group ModifierOnlyShortcuts --key Meta "org.kde.lattedock,/Latte,org.kde.LatteDock,activateLauncherMenu"
qdbus org.kde.KWin /KWin reconfigure</nowiki>}}
qdbus org.kde.KWin /KWin reconfigure</nowiki>}}


Line 96: Line 86:
[https://bugs.kde.org/show_bug.cgi?id=382219 KWin bug report] [https://bugs.kde.org/show_bug.cgi?id=392464 Plasma bug report]
[https://bugs.kde.org/show_bug.cgi?id=382219 KWin bug report] [https://bugs.kde.org/show_bug.cgi?id=392464 Plasma bug report]


== Is there a way to tell Latte Dock to launch only for a Plasma session ? == <!--T:90-->
== Is there a way to tell Latte Dock to launch only in '''Plasma Session''' ? == <!--T:90-->


<!--T:91-->
<!--T:91-->
Line 110: Line 100:
# <menuchoice>Advanced</menuchoice> &rarr; <menuchoice>Autostart only in Plasma</menuchoice>.
# <menuchoice>Advanced</menuchoice> &rarr; <menuchoice>Autostart only in Plasma</menuchoice>.


== Is there any other hiccup or potential problem I should be careful of? == <!--T:93-->
== What happens if I drag 'n' drop files on launchers? == <!--T:113-->


<!--T:94-->
<!--T:114-->
Software, like everything else in life, isn't perfect; we constantly try to make better software and you can help
The file will be passed as a parameter to the specific application, creating a new instance (e.g. passing an image to '''Kolourpaint''' will open the image with '''Kolourpaint''').
us out by reporting every possible problem you may find. To answer the question though, there isn't a bug serious enough to prevent you from trying '''Latte Dock'''.


== Are there any hopes and wishes for features from the Plasma upstream? == <!--T:95-->
== My right click does not work ? == <!--T:119-->


<!--T:96-->
<!--T:120-->
The most important feature needed from KWin in Wayland is that distros provide access to KWayland's privileged APIs ''and/or'' for the users, a confirmation from them that Latte requests such APIs.
When right-click does not work both for applets and tasks it means that your Latte has not been built with the same KDE Frameworks libraries like Plasma Desktop. The only solution is either your distro to update its Latte package properly or to build Latte by yourself.


== How often will new versions be released and what are your plans? == <!--T:97-->
== How can I set the maximum icon size for applets in Plasma panels? == <!--T:132-->  


<!--T:98-->
<!--T:133-->
The first priority needed to release a stable version is that all the needed features are implemented and no major crashes appear. We are of course trying to keep the schedule, but on the other hand, ''it will be ready when it is ready'' is the better philosophy we should follow in order to provide a complete and stable release for our users.
If you want to set 192px. as maximum icon size for applets in panels you can execute:


== I am a complete newbie but I want to help somehow. What can I do? == <!--T:99-->
<!--T:134-->
{{Input|1=<nowiki>kwriteconfig --file ~/.config/kdeglobals --group PanelIcons --key Size "192"</nowiki>}}


<!--T:100-->
<!--T:135-->
By the time this F.A.Q. was written, much help is needed to make '''Latte''' stable with multi-screen setups. You could clone the
In the previous example, any plasma applets larger than 192px. are going to use their full Desktop representation when are placed inside panels.
"multiscreens" branch and report back any issues. Normal bug reports, reports about problems with specific Plasma or Qt versions, strange desktop behavior or even wishes about new features are all welcome as well. {{Smiley}}


== I know how to program. What can I do to help? == <!--T:101-->
== How can I improve CPU usage? == <!--T:136-->  


<!--T:102-->
<!--T:137-->
The first step is to know what you are after and then to fork the repo; after that, you can hunt for bugs, add new features - or make already existing features more stable. Discuss your changes and if they are good and reasonable enough, we are more than happy if you provide a pull request.
Latte, in general, has as a focus to provide maximum configurability and performance, so all its graphics and animations are set to BEST values...


== How can I install from the current master branch? == <!--T:103-->
<!--T:138-->
An easy and known solution if you want better CPU usage it to DISABLE tasks/applets shadows. Latte is using DropShadow qml element extensively and it is quite costly. To disable all shadows in a dock, you can do:


<!--T:104-->
<!--T:139-->
You can easily download and install from the latest master branch by running a script with the following commands:
'''Right click Dock -> Edit Dock... -> Effects -> "Shadows" [disable that options group from its header]'''


<!--T:105-->
<!--T:140-->
{{Input|1=<nowiki>git clone https://github.com/psifidotos/Latte-Dock.git
In my system, when using the parabolic effect, ''CPU usage is dropped around 75%''
cd Latte-Dock
sh install.sh</nowiki>}}


<!--T:106-->
== My badge counters do not work in Latte Dock. How can I fix it? == <!--T:141-->
The last command might ask for your root password just before installing.


== How can I install from a specific branch? == <!--T:107-->
<!--T:142-->
Please make sure you have libunity installed. On KDE versions of Ubuntu such as Kubuntu and KDE Neon, you will need <code>libunity-dev</code> installed.


<!--T:108-->
== How can I autocolor my Latte panel based on specific application? == <!--T:148-->
If you want to test some features that currently don't exist in the master branch, you have to checkout the branch you wish to install. Let's say you need the ''multi2'' branch:


<!--T:109-->
<!--T:149-->
{{Input|1=<nowiki>git clone https://github.com/psifidotos/Latte-Dock.git
# Install <menuchoice>Latte Window Colors </menuchoice> KWin script from [https://store.kde.org/p/1290287/ KDE Store]</translate>
cd Latte-Dock
<translate>
git pull
<!--T:150-->
git branch multi2
# Right click <menuchoice>Latte Panel</menuchoice> &rarr; <menuchoice>Edit Panel...</menuchoice> &rarr; <menuchoice>Appearance</menuchoice> &rarr; <menuchoice>Colors</menuchoice> &rarr; <menuchoice>From Window</menuchoice> &rarr; <menuchoice>Any Touching Window</menuchoice></translate>
git checkout multi2
<translate>
git pull origin multi2</nowiki>}}
<!--T:151-->
# Specify different color schemes for your applications:</translate>
<translate>
<!--T:152-->
#* Right click <menuchoice>Window Titlebar</menuchoice></translate>
<translate>
<!--T:153-->
#* <menuchoice>More Actions</menuchoice> &rarr; <menuchoice>Configure Special Application Settings...</menuchoice></translate>
<translate>
<!--T:154-->
#* <menuchoice>Add Property</menuchoice> &rarr; <menuchoice>Appearance and Fixes</menuchoice> &rarr; <menuchoice>Titlebar color scheme</menuchoice></translate>
<translate>
<!--T:155-->
#* Select <menuchoice>Force</menuchoice> &rarr; <menuchoice>Choose your preferred color scheme</menuchoice>


<!--T:110-->
== Can I disable autocolor for specific applet? == <!--T:161-->
Compile as usual.


== What happens if I drag 'n' drop files on launchers? == <!--T:111-->
<!--T:162-->
Yes, right click <menuchoice>Dock</menuchoice> &rarr; <menuchoice>Edit Dock...</menuchoice> &rarr; <menuchoice>Rearrange and configure your widgets</menuchoice> &rarr; <menuchoice>Disable "drop" icon</menuchoice> from mentioned applet tooltip


<!--T:112-->
The file will be passed as a parameter to the specific application, creating a new instance (e.g. passing an image to '''Kolourpaint''' will open the image with '''Kolourpaint''').


== Are there known compatibility issues with specific graphics drivers? == <!--T:113-->
== Are there any known compatibility issues with specific graphics drivers? == <!--T:115-->


<!--T:114-->
<!--T:116-->
If you have Intel Graphics and experience problems with rendering such as pixelated graphics, corrupt text and others, you can try changing the 2D rendering method from ''SNA'' to ''UXA''.
If you have Intel Graphics and experience problems with rendering such as pixelated graphics, corrupt text and others, you can try changing the 2D rendering method from ''SNA'' to ''UXA''.


<!--T:115-->
<!--T:117-->
{{Path|1=/etc/X11/xorg.conf.d/20-intel.conf}}
{{Path|1=/etc/X11/xorg.conf.d/20-intel.conf}}


<!--T:116-->
<!--T:118-->
{{Input|1=<nowiki>
{{Input|1=<nowiki>
section    "Device"
section    "Device"
Line 187: Line 185:
EndSection</nowiki>}}
EndSection</nowiki>}}


== My right click does not work ? == <!--T:117-->
== Can I have different '''Borderless Maximized''' windows options between different layouts? == <!--T:156-->
 
<!--T:118-->
When right-click does not work both for applets and tasks it means that your Latte has not been built with the same KDE Frameworks libraries like Plasma Desktop. The only solution is either your distro to update its Latte package properly or to build Latte by yourself.
 
== How can I set the maximum icon size for applets in Plasma panels? == <!--T:120-->  


<!--T:121-->
<!--T:157-->
If you want to set 192px. as maximum icon size for applets in panels you can execute:
1. Yes, this is possible. First enable this functionality in Latte's Preferences settings:


<!--T:122-->
<!--T:158-->
{{Input|1=<nowiki>kwriteconfig --file ~/.config/kdeglobals --group PanelIcons --key Size "192"</nowiki>}}
[[File:Borderless.png]]


<!--T:123-->
<!--T:159-->
In the previous example, any plasma applets larger than 192px. are going to use their full Desktop representation when are placed inside panels.
2. Enable/Disable this functionality per layout on the Latte Layout settings afterwards.


== How can I improve CPU usage? == <!--T:124-->  
<!--T:160-->
 
[[File:Layout.png]]
<!--T:125-->
Latte, in general, has as a focus to provide maximum configurability and performance, so all its graphics and animations are set to BEST values...
 
<!--T:126-->
An easy and known solution if you want better CPU usage it to DISABLE tasks/applets shadows. Latte is using DropShadow qml element extensively and it is quite costly. To disable all shadows in a dock, you can do:
 
<!--T:127-->
'''Right click Dock -> Dock settings - Effects -> "Shadows" [disable that options group from its header]'''
 
<!--T:128-->
In my system, when using the parabolic effect, ''CPU usage is dropped around 75%''
 
== My badge counters don't work in latte-dock. How can fix it? == <!--T:129-->
 
<!--T:130-->
Please make sure you have libunity installed. On KDE versions of Ubuntu such as Kubuntu and KDE Neon, you will need <code>libunity-dev</code> installed.


</translate>
</translate>

Latest revision as of 11:54, 12 June 2022

Other languages:

←Latte Dock

Latte Dock!
Latte Dock!

What is Latte Dock? How did it begin?

Latte Dock is a dock based on plasma frameworks and a direct successor of Now Dock. Latte is the combined effort from the developers of Now Dock and Candil Dock.

Which Linux distros provide "Out Of The Box" Latte Dock experience?

How can I add launchers?

The easiest and most memory-efficient way to do so is to drag n' drop them on the task manager (this is the area where dots and lines are shown under running windows).

You can also add them outside the task manager, but this creates animation issues for sizes <64px and it is memory hungry.

My launcher and its window are not associated correctly OR my launcher is using a low-resolution icon?

This issue means that plasma libtaskmanager has not associated your launcher and app windows correctly to the relevant desktop file. Plasma is trying to be smart enough in order to correctly identify which desktop files are associated to which specific windows, but there are cases when it fails. Best way to solve this is to check the StartupWMClass record in the desktop file. This record should point at the proper WM_CLASS record at all times. For example even though the Latte Dock desktop file is called org.kde.latte-dock.desktop, its StartupWMClass is lattedock. In order to correctly identify the StartupWMClass of an application, you can use xprop.

Example:

  1. Run xprop from the command line.
  2. Click on the window you are interested in.
  3. Locate at the end of the output the record WM_CLASS(STRING) =.
  4. Add the previously mentioned record in the application desktop file at the StartupWMClass field.

For instance, with "Gimp 2.10", even though its desktop file is called gimp.desktop, its StartupWMClass is "gimp-2.10". StartupWMClass is not needed to be added for "Gimp" since plasma developers have taken special care to map it properly through /etc/xdg/taskmanagerrulesrc.

How can I enable Latte Global Shortcuts?

In most cases you need to go to Plasma System SettingsGlobal ShortcutsLatte Dock and enable what shortcuts you need.

  • Super + Number : Activate a task
  • Super + Ctrl + Number : A new instance for a task
  • Super + `: Show a hidden dock

Can I use my super key to open the app launcher?

  • The official way to enable this is to right click DockConfigure Latte...Enable autostart during startup
  • The manual way is to Close LatteExecute in command prompt:
    kwriteconfig5 --file ~/.config/kwinrc --group ModifierOnlyShortcuts --key Meta "org.kde.lattedock,/Latte,org.kde.LatteDock,activateLauncherMenu"
    qdbus org.kde.KWin /KWin reconfigure

Launchers are disappearing before the relevant window is shown even though they shouldn't.

We are acquainted with this, but this behavior is provided by plasma's libtaskmanager. You can read more at: Latte Issue #72, KDE bug report

My left dock behaves strangely from Plasma 5.10 onwards, how can I fix this?

In Plasma 5.10, the KWin developers introduced gesture functionality for touch screens, which is enabled by default for all systems. You can disable it through plasma System SettingsWorkspace BehaviorTouchscreen. Relogin your plasma session if the change doesn't take effect immediately.

KWin bug report Plasma bug report

Is there a way to tell Latte Dock to launch only in Plasma Session ?

Of course you can, please follow these steps:

  1. Go to System SettingsStartup and ShutdownAutostart.
  2. Choose Latte Dock from the applications list.
  3. AdvancedAutostart only in Plasma.

What happens if I drag 'n' drop files on launchers?

The file will be passed as a parameter to the specific application, creating a new instance (e.g. passing an image to Kolourpaint will open the image with Kolourpaint).

My right click does not work ?

When right-click does not work both for applets and tasks it means that your Latte has not been built with the same KDE Frameworks libraries like Plasma Desktop. The only solution is either your distro to update its Latte package properly or to build Latte by yourself.

How can I set the maximum icon size for applets in Plasma panels?

If you want to set 192px. as maximum icon size for applets in panels you can execute:

kwriteconfig --file ~/.config/kdeglobals --group PanelIcons --key Size "192"

In the previous example, any plasma applets larger than 192px. are going to use their full Desktop representation when are placed inside panels.

How can I improve CPU usage?

Latte, in general, has as a focus to provide maximum configurability and performance, so all its graphics and animations are set to BEST values...

An easy and known solution if you want better CPU usage it to DISABLE tasks/applets shadows. Latte is using DropShadow qml element extensively and it is quite costly. To disable all shadows in a dock, you can do:

Right click Dock -> Edit Dock... -> Effects -> "Shadows" [disable that options group from its header]

In my system, when using the parabolic effect, CPU usage is dropped around 75%

My badge counters do not work in Latte Dock. How can I fix it?

Please make sure you have libunity installed. On KDE versions of Ubuntu such as Kubuntu and KDE Neon, you will need libunity-dev installed.

How can I autocolor my Latte panel based on specific application?

  1. Install Latte Window Colors KWin script from KDE Store
  2. Right click Latte PanelEdit Panel...AppearanceColorsFrom WindowAny Touching Window
  3. Specify different color schemes for your applications:
    • Right click Window Titlebar
    • More ActionsConfigure Special Application Settings...
    • Add PropertyAppearance and FixesTitlebar color scheme
    • Select ForceChoose your preferred color scheme

Can I disable autocolor for specific applet?

Yes, right click DockEdit Dock...Rearrange and configure your widgetsDisable "drop" icon from mentioned applet tooltip


Are there any known compatibility issues with specific graphics drivers?

If you have Intel Graphics and experience problems with rendering such as pixelated graphics, corrupt text and others, you can try changing the 2D rendering method from SNA to UXA.

/etc/X11/xorg.conf.d/20-intel.conf

section     "Device"
Identifier  "Intel Graphics"
Driver      "intel"
Option      "AccelMethod"  "uxa"
EndSection

Can I have different Borderless Maximized windows options between different layouts?

1. Yes, this is possible. First enable this functionality in Latte's Preferences settings:

2. Enable/Disable this functionality per layout on the Latte Layout settings afterwards.