aboutsummaryrefslogtreecommitdiffstats

ScudCloud - Linux Client for Slack

ScudCloud Logo

ScudCloud is a non official open-source Linux (Debian, Ubuntu, Kubuntu, Mint, Arch, Fedora) desktop client for Slack.

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:

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, 15.10), Mint and Debian, open a Terminal (Ctrl+Alt+T) and run:

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 to your home folder saving as scudcloud.png and run:

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):

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.

Arch Linux

There is a PKGBUILD available on the Arch User Repository. You can install it using whichever AUR method you use. For instance, if you use cower:

cower -d scudcloud
cd scudcloud
makepkg -si

Fedora and openSUSE

There are repositories available for these distributions. All you need to do is follow these instructions.

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:

wget https://github.com/raelgc/scudcloud/archive/v1.1.1.tar.gz
tar -xvf v1.1.1.tar.gz
cd scudcloud-1.1.1
SOURCE="scudcloud-1.1"
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. In this meanwhile, try the 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 Ctrl +, usually fired with Ctrl Shift =
  • Decrease with Ctrl -
  • Reset it with Ctrl 0

Screenshots

Some screenshots

License

ScudCloud is is released under the MIT License.