Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
panel-plugins:xfce4-docklike-plugin:start [2021/09/15 21:44] – created docklike-plugin page davekeoghpanel-plugins:xfce4-docklike-plugin:start [2024/12/09 09:45] (current) – kevinbowen
Line 3: Line 3:
 ====== xfce4-docklike-plugin - Docklike Taskbar ====== ====== xfce4-docklike-plugin - Docklike Taskbar ======
  
-A modern, minimalist taskbar for Xfce+A modern, minimalist taskbar for Xfce.
  
-  * **[[#Usage|Usage]]**+Docklike Taskbar behaves similarly to many other desktop environments and operating systems. Wherein all application windows are grouped together as an icon and can be pinned to act as a launcher when the application is not running. Commonly referred to as a dock. 
 + 
   * **[[#Screenshots|Screenshots]]**   * **[[#Screenshots|Screenshots]]**
 +  * **[[#Usage|Usage]]**
 +  * **[[#Theming|Theming]]**
   * **[[#Latest Release|Latest Release]]**   * **[[#Latest Release|Latest Release]]**
   * **[[#Source Code Repository|Source Code Repository]]**   * **[[#Source Code Repository|Source Code Repository]]**
Line 13: Line 16:
 ---- ----
  
-===== Usage ===== 
  
-...+===== Screenshots =====
  
-----+<figure "Docklike Properties Dialog"> 
 +{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-properties.png|Docklike Properties Dialog}} 
 +</figure>
  
-===== Screenshots =====+<figure "Docklike Window List"> 
 +{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-switch.png|Docklike Window List}} 
 +</figure>
  
-<figure "Properties Dialog"> +<figure "Docklike Window Preview"> 
-{{:panel-plugins:xfce4-docklike-plugin-properties.png|Properties Dialog}}+{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-previews.png|Docklike Window Preview}} 
 +</figure> 
 + 
 +<figure "Docklike Alternate Indicator Styles: Dashes"> 
 +{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-dashes.png|Docklike Alternate Indicator Styles: Dashes}} 
 +</figure> 
 + 
 +<figure "Docklike Alternate Indicator Styles: Dots"> 
 +{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-dots.png|Docklike Alternate Indicator Styles: Dots}}
 </figure> </figure>
  
 [[|Back to Top]] [[|Back to Top]]
 +
 +----
 +
 +===== Usage =====
 +
 +  - [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]].
 +  - Right-click on the added plugin, select **Properties** to open the settings window. 
 +
 +**Mouse Actions**
 +  * **ctrl+left-click** to begin dragging an item in the dock
 +  * **ctrl+right-click** to access Properties, move/remove the plugin
 +  * **shift+click** to launch another instance of an application
 +  * **middle-click** to close all instances of an application
 +  * **mouse wheel** to cycle through open windows in either direction
 +
 +**Keyboard Shortcuts**
 +
 +Keyboard shortcuts are disabled by default. Be careful to avoid conflicting keyboard shortcuts!
 +
 +  * **super+[1,2,...]** to switch between applications based on dock position
 +  * **super** to switch to the previous window
 +
 +It would be nice to add a setting to change the modifier key in the future.
 +
 +**Hidden Settings**
 +
 +Your settings file is located at //~/.config/xfce4/panel/docklike-1.rc// (or something like that). The file is only created after changing anything in the xfce4-docklike-plugin Properties window.
 +
 +  * **dockSize=<int>** sets the minimum width/height (depending on panel orientation) of the dock widget (unset by default)
 +  * **previewScale=<double>** adjusts the scale factor of preview images (the default value is 0.125)
 +  * **previewSleep=<int>** adjusts the time, in milliseconds, between new preview images being generated (the default is 250)
 +
 +[[|Back to Top]]
 +
 +----
 +
 +===== Theming =====
 +You can modify the appearance of dock items with CSS. Create (or modify) //~/.config/gtk-3.0/gtk.css// and add any of the following:
 +
 +    /* Taller or wider buttons */
 +    #docklike-plugin button {
 +      min-height: 48px;
 +      min-width: 48px;
 +    }
 +    
 +    /* Brightly colored buttons */
 +    #docklike-plugin .open_group { background-color: lightblue; }
 +    #docklike-plugin .active_group { background-color: hotpink; }
 +    #docklike-plugin .hover_group { background-color: orange; }
 +    
 +    /* number of open windows label */
 +    #docklike-plugin .window_count { color: red; }
 +    #docklike-plugin .open_group .window_count { color: white; }
 +    #docklike-plugin .active_group .window_count { color : hotpink; }
 +
 +A list of all the CSS selectors created by the plugin:
 +
 +    #docklike-plugin
 +      .group
 +      .open_group
 +      .active_group
 +      .window_count
 +      .menu
 +      .active_menu_item
 +      .hover_menu_item
 +
 +Changes will take effect after the panel is restarted (//xfce4-panel -r//).
  
 ---- ----
Line 31: Line 112:
 ===== Latest Release ===== ===== Latest Release =====
  
-{{rss>https://archive.xfce.org/feeds/project/xfce4-docklike-plugin 1 date description 2h}}+{{rss>https://archive.xfce.org/feeds/project/xfce4-docklike-plugin 1 date 2h}}
  
-  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-docklike-plugin/|Previous Releases]]**+[[https://gitlab.xfce.org/panel-plugins/xfce4-docklike-plugin/-/blob/master/NEWS|Read the CHANGELOG]] 
 + 
 +  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-docklike-plugin/|Download current release]]** (older versions of this component are also available here)
  
 [[|Back to Top]] [[|Back to Top]]
Line 40: Line 123:
  
 ===== Source Code Repository ===== ===== Source Code Repository =====
 +
 [[https://gitlab.xfce.org/panel-plugins/xfce4-docklike-plugin/]] [[https://gitlab.xfce.org/panel-plugins/xfce4-docklike-plugin/]]
  
Line 45: Line 129:
  
 ===== Reporting Bugs ===== ===== Reporting Bugs =====
-[[https://gitlab.xfce.org/panel-plugins/xfce4-docklike-plugin/-/issues]] -- Open bug reports and how to report new bugs+ 
 +  * **[[:panel-plugins:xfce4-docklike-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports 
  
 [[|Back To Top]] [[|Back To Top]]
  
 ---- ----
- +[[ :xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]
-[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]+