README

#

### Introduction

Dash to Panel is an icon taskbar for Gnome Shell. This extension moves the dash into the gnome main panel so that the application launchers and system tray are combined into a single panel, similar to that found in KDE Plasma and Windows 7+. A separate dock is no longer needed for easy access to running and favorited applications.

#

### Features

Live Previews on Hover
Hover over the launcher icon for an open application to get a live window preview

Customizable running indicators | ALT Indicators
--- | ---

Launch by Number
Optionally launch your favorite applications via keyboard

Additional Features | Feature Implemented
--- | ---
Set main panel position (top or bottom) and height |
Configure clock location |
Remove "Show Apps" icon from dash |
Add "Show Desktop" button to panel |
Hide Show Apps, Activities and App Menu buttons from panel |
Isolate running apps in workspaces |
Custom click behaviors (launch new window, cycle open windows, minimize, etc) |
Assign font & icon sizes and margins for panel elements |
Integrate native Gnome appMenu into right-click secondary menu |

#

### Installation

To install the most recent official release:
Visit Dash-to-Panel at GNOME Extensions

To install a development version from source, please see the Installation wiki page.

### FAQ

How do I embed my bottom left notification drawer into the panel like a system tray? Top Icons Plus

How do I add a traditional start menu? Arc Menu or Gno-Menu

How do I disable the hot corner? No Topleft Hot Corner

How do I move the notifications to somewhere other than the top center? Panel OSD

How do I add transparency to the panel? Dynamic Panel Transparency

How do I change workspaces by scrolling the mouse wheel in the empty space? Top Panel Workspace Scroll

How do I display Minimize & Maximize buttons? In the Tweak Tool application, turn on `Windows > Titlebar Buttons > Minimize & Maximize`.

Why can't I put the panel vertically on the left or right of the display? Gnome-shell and it's numerous extensions add widgets to the panel. These widgets have been designed using padding and absolute positioning assuming a horizontal layout. At this point in time, I don't think it is possible to allow for a vertical layout and still maintain any sort of reasonable compatibility with many of the other features of Gnome.

### Themes

While this extension works well with most popular Gnome Shell themes, the following themes are known to have explicitly added custom styles for this extension:

- Ciliora Tertia / Ciliora Secunda
- Plano

### Compatibility

This extension has been tested with Gnome 3.18+.

This extension manipulates the Gnome Main Panel, aka Top Bar. So, most other extensions which operate on the top bar should be compatible.

#

### Volunteers needed!

This extension could be even better with your help! Any items in the issue tracker labelled `help wanted` or `good first issue` are up for grabs. For more info, see the Contributing wiki page.

### Credits

This extension is developed and maintained by @jderose9 and @charlesg99.

Significant portions of code in this extension were derived from Dash-to-Dock.

Additional credits: This extension leverages the work for ZorinOS Taskbar (used in ZorinOS) to show window previews and allow the dash from Dash-to-Dock to be embedded in the Gnome main panel.
Code to set anchor position taken from Thoma5/gnome-shell-extension-bottompanel.
Pattern for moving panel contents based on Frippery Move Clock by R M Yorston.
Ideas for recursing child actors and assigning inline styles are based on code from the extension StatusAreaHorizontalSpacing.

#

#### Thanks to the following people for contributing via pull requests:

- @franglais125 for launching apps by number (w/ overlay), bug fixes, and issue support
- @charlesg99 for intellihide, ungrouping applications/showing window titles, bug fixes, and issue support
- @LinxGem33 for artwork, logos, screenshots and design effort
- @dziku1337 for peek mode in window previews
- @robrobinbin for configuring appMenu on/off in the panel
- @MartinPL for toggling favorites on/off in panel
- @jackwickham for thumbnail middle and right click actions
- @abakkk for centering the taskbar icons in the panel
- @quasoft for changing of font weight of ungrouped application titles

#### Bug Fixes:

@imrvelj, @Teslator, @bil-elmoussaoui, @brandon-schumann, @sw9, @rockon999 , @lexruee, @3v1n0, @freeroot, @moqmar, @ArtyomZorin

#### Translations:

@frnogueira (pt_BR), @zeten30 (cs), @franglais125 (es), @LaurentTreguier / @SolarLiner (fr), @elsieholmes (uk), @hosiet (zh_CN), @jonnius (de), @urbalazs / @pappfer (hu), @crayxt (kk), @pkomur (pl), @AlexGluck (ru), @oltulu (tr)

### License & Terms

Dash to Panel is available under the terms of the GPL-v2 or later license See `COPYING` for details.