File: README.md

package info (click to toggle)
gnome-shell-extension-top-icons-plus 19-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 3,120 kB
  • ctags: 21
  • sloc: xml: 40; makefile: 24
file content (155 lines) | stat: -rw-r--r-- 4,433 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
# TopIcons Plus

## Introduction

Topicons Plus is an alternative to the Gnome Shell Legacy Tray, which is hidden most of the time and generally considered inconvenient.

It brings all icons to back to the top panel, as with most desktop environments.

With colors:

![Tray](https://raw.githubusercontent.com/phocean/TopIcons/master/screenshots/tray1.png)

Grayscale alternative (desaturation setting):

![Tray](https://raw.githubusercontent.com/phocean/TopIcons/master/screenshots/tray2.png)

There were an original TopIcons extension for that, but it stopped being maintained and it had a few issues and little configuration options.
Thus, this fork.

Before (standard Gnome legacy tray, bottom left):

![Before](https://raw.githubusercontent.com/phocean/TopIcons/master/screenshots/before.png)

After:

![After](https://raw.githubusercontent.com/phocean/TopIcons/master/screenshots/after.png)

Enjoy it!


## Installation

Pre-Requisite: You need the *make* utility :

```bash
# Debian, Ubuntu
apt-get install make
# RedHad, Fedora
dnf install make
```

Download the code to any folder, e.g. <code>/home/$USER/Downloads</code>, using these commands :

```bash
cd /home/$USER/Downloads
git clone https://github.com/phocean/TopIcons.git
```

Move to the downloaded folder and execute the installation script:

```bash
cd TopIcons
make
```

The whole process should look similar to this:

```bash
% make
glib-compile-schemas schemas
rm -rf _build
mkdir _build
cp -r schemas convenience.js extension.js metadata.json prefs.js README.md _build
echo Build was successfull 
Build was successfull
rm -rf ~/.local/share/gnome-shell/extensions/TopIcons@phocean.net
mkdir -p ~/.local/share/gnome-shell/extensions/TopIcons@phocean.net
cp -r _build/* ~/.local/share/gnome-shell/extensions/TopIcons@phocean.net
rm -rf _build
echo Installed in ~/.local/share/gnome-shell/extensions/TopIcons@phocean.net
Installed in /home/phocean/.local/share/gnome-shell/extensions/TopIcons@phocean.net
% 
```

To avoid any Gnome update issue ([see the official statement](https://git.gnome.org/browse/gnome-shell/commit/?id=5e0e3ed)), make sure that version check is disabled:

```bash
gsettings set org.gnome.shell disable-extension-version-validation "true"
```


This moved the extension to <code>~/.local/share/gnome-shell/extensions</code> with the proper naming convention.

Now, reload GNOME Shell with <code>Alt+F2</code> and then <code>r</code> or login/logout.

![Reload Gnome](https://raw.githubusercontent.com/phocean/TopIcons/master/screenshots/reload.png)

Finally, launch the *gnome-tweak-tool* utility to manage extensions.
There, you can enable *TopIcons Plus* and then tweak its appearance settings:

![Enable TopIcons](https://raw.githubusercontent.com/phocean/TopIcons/master/screenshots/tweak.png)

## Compatibility

GNOME Shell 3.16 and up.

## Changelog

v16:

* Updated Gnome version support
* Documentation updates
* Minor changes to the icon box layout (margin)

## Known issues

### Dropbox

The Dropbox notification icon sometimes trashes the tray (also buggy with the Gnome legacy tray).

You can restore the tray by reloading Gnome-shell (ALT-F2, r).

On a longer term, you can solve this problem using:

- *systemd* to launch Dropbox (instead of as a Gnome startup application),
- rely on the *Dropbox nautilus extension* to get a visual feedback on the synchronization status.

Here is the systemd script to run it in the user context (thanks @robolange for the tip):

```bash
$ cat ~/.config/systemd/user/dropbox.service
[Unit]
Description=Dropbox Service

[Service]
Type=forking
ExecStart=/usr/bin/dropbox start
ExecStop=/usr/bin/dropbox stop
PIDFile=${HOME}/.dropbox/dropbox.pid
Restart=on-failure
RestartSec=5
StartLimitInterval=60s
StartLimitBurst=3

[Install]
WantedBy=default.target
```

Which you can enable with these commands:

```bash
systemctl --user enable dropbox
systemctl --user start dropbox
```


## Credits

Many thanks go to Adel Gadllah for making the [original extension](http://94.247.144.115/repo/topicons/) and also to Mjnaderi for the [Toptray fork](https://github.com/mjnaderi/TopTray).

Also, thanks to all contributors (code and issues), and especially to [nevesnunes](https://github.com/nevesnunes) for the very nice code improvements he brought up!

## Notes

The extension is pending review on https://extensions.gnome.org, so hopefully it will be validated so that it is easier to install soon.