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
156
157
158
159
160
161
162
163
164
165
166
167
168
|
# ScudCloud - Linux Client for Slack
ScudCloud is a **non official** open-source Linux (Debian, Ubuntu, Kubuntu, Mint, Arch, Fedora) desktop client for [Slack](http://slack.com).
ScudCloud improves the Slack integration with Linux desktops featuring:
* multiple teams support,
* native system notifications,
* count of unread direct mentions at launcher/sytray icon,
* alert/wobbling on new messages,
* channels quicklist (Unity only),
* optional "Close to Tray".
# Install
## Ubuntu/Kubuntu and Mint
Please, first update your system with:
```term
sudo apt-get update && sudo apt-get upgrade
```
If not, ScudCloud will crash with some old components or will not be installed.
Then, to install it under **Ubuntu/Kubuntu** (14.04, 14.10, 15.04), **Mint** and **Debian**, open a Terminal (Ctrl+Alt+T) and run:
```term
sudo apt-add-repository -y ppa:rael-gc/scudcloud
sudo apt-get update
sudo apt-get install scudcloud
```
If you want **spell checking**, add the `hunspell` dictionary for your language. For `en-us`:
sudo apt-get install hunspell-en-us
If you want to use a Slack icon instead of ScudCloud (which is not possible to include in this package due to copyright), download [any 128px Slack icon](https://www.google.com.br/search?q=slack+icon&tbm=isch&source=lnt&tbs=isz:ex,iszw:128,iszh:128) to your home folder saving as `scudcloud.png` and run:
```term
sudo dpkg-divert --add --rename --divert /opt/scudcloud/resources/scudcloud.png.real /opt/scudcloud/resources/scudcloud.png
sudo cp ~/scudcloud.png /opt/scudcloud/resources/
sudo chmod +r /opt/scudcloud/resources/scudcloud.png
```
## Ubuntu 12.04
For Ubuntu 12.04 (Precise Pangolin), **additionally** you'll need to update `qtwebkit`: Slack is not compatible with `libqtwebkit4` package shipped with 12.04, hanging in the `Loading` screen. Please add the following PPAs (for updated `qtwebkit`):
```term
sudo add-apt-repository -y ppa:immerrr-k/qtwebkit4-backport
sudo apt-get update
```
## Debian
Make sure `software-properties-common` is installed, then run:
```
sudo apt-add-repository -y ppa:rael-gc/scudcloud
sudo sed -i 's/jessie/trusty/g' /etc/apt/sources.list.d/rael-gc-scudcloud-jessie.list
sudo apt-get update
sudo apt-get install scudcloud
```
If you want spell checking and a Slack icon, follow related instructions on [Ubuntu Install section](#ubuntukubuntu-and-mint).
## Arch Linux
There is a [PKGBUILD available][pkgbuild] on the Arch User Repository. You can install it
using whichever AUR method you use. For instance, if you use cower:
```term
cower -d scudcloud
cd scudcloud
makepkg -si
```
[pkgbuild]: https://aur.archlinux.org/packages/scudcloud/
## Fedora and openSUSE
There are repositories available for these distributions. All you need to do is follow [these instructions][build_suse].
[build_suse]: http://software.opensuse.org/download.html?project=home%3Amoonwolf%3Ascudcloud&package=scudcloud
## Manual Install
The manual install is intended for not supported distros (if you want to contribute with a package for your distro, you're welcome!).
First, you'll need to install at least packages for `python3`, `python-qt4` (`qt4` for `python3`) and `python-dbus` (`dbus` library for `python3`).
Then run the below script: it'll download the code and install it:
```bash
wget https://github.com/raelgc/scudcloud/archive/v1.0.85.tar.gz
tar -xvf v1.0.85.tar.gz
cd scudcloud-1.0.85
SOURCE="scudcloud-1.0"
INSTALL="/opt/scudcloud"
sudo mkdir -p $INSTALL/lib
sudo mkdir -p $INSTALL/resources
sudo cp $SOURCE/lib/*.py $INSTALL/lib
sudo cp $SOURCE/resources/* $INSTALL/resources
sudo cp $SOURCE/scudcloud $INSTALL
sudo cp $SOURCE/LICENSE $INSTALL
sudo cp $SOURCE/scudcloud.desktop /usr/share/applications
sudo cp $SOURCE/systray/hicolor/* /usr/share/icons/hicolor/scalable/apps
sudo cp $SOURCE/systray/mono-dark/* /usr/share/icons/mono-dark/scalable/apps
sudo cp $SOURCE/systray/mono-light/* /usr/share/icons/mono-light/scalable/apps
sudo ln -sf $INSTALL/scudcloud /usr/bin/scudcloud
```
# Troubleshooting
#### 1. Default domain
You can change the default domain editing or just deleting the config file:
~/.config/scudcloud/scudcloud.cfg
#### 2. Where is the package for my distro?
If not listed above, you're welcome [to contribute](/CONTRIBUTING.md). In this meanwhile, try the [Manual Install](#manual-install) instructions.
#### 3. Spell checking is not working
Make sure you have the following packages installed:
* `libqtwebkit-qupzillaplugins`
* `python3-hunspell`
* `hunspell-en-us`
#### 4. `Keep me signed in` is not working
For some reason, ScudCloud was not able to create the configuration folder. Please, manually create this folder:
~/.config/scudcloud/
#### 5. How to disable Flash?
Flash is required to display embedded videos, but if you don't care, disable it starting with:
scudcloud --no_plugins=True
#### 6. How to start ScudCloud minimized?
You can start ScudCloud minized to tray with:
scudcloud --minimized=True
#### 7. High DPI Support
ScudCloud offers zoom support. The zoom level will be persisted between sessions.
- Increase zoom pressing <kbd>Ctrl +</kbd>, usually fired with <kbd>Ctrl Shift =</kbd>
- Decrease with <kbd>Ctrl -</kbd>
- Reset it with <kbd>Ctrl 0</kbd>
# Screenshots
# License
ScudCloud is is released under the [MIT License](/LICENSE).
|
