/scudcloud

ScudCloud - Slack for Linux

Primary LanguagePythonMIT LicenseMIT

ScudCloud - Linux Client app for Slack

ScudCloud Slack app on Ubuntu Unity

ScudCloud is a non official open-source Linux (Debian, Ubuntu, Kubuntu, Mint, Arch, Fedora) desktop client app 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 tray notifications and "Close to Tray"
  • follow your desktop activity and will stay online while you're logged in (if correct packages are installed)

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

sudo apt-add-repository -y ppa:rael-gc/scudcloud
echo ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true | sudo debconf-set-selections
sudo apt-get update
sudo apt-get install scudcloud

If you want spell checking, add the hunspell dictionary for your language and make sure dependencies are installed. For en-us:

sudo apt-get install hunspell-en-us libqtwebkit-qupzillaplugins python3-hunspell

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 /usr/share/pixmaps/scudcloud.png.real /usr/share/pixmaps/scudcloud.png
sudo cp ~/scudcloud.png /usr/share/pixmaps/
sudo chmod +r /usr/share/pixmaps/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
sudo apt-get upgrade

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

openSUSE

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

Fedora

sudo dnf install 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, python3-setuptools, python-qt4 (qt4 for python3) and python-dbus (dbus library for python3).

Then run the following steps:

  1. Download the latest release
  2. Unpack/unzip it
  3. Change into the newly created directory
  4. Run sudo python3 setup.py install

Running From Dev Tree

ScudCloud can be run from the development tree. Simply run the following from the root of the project tree:

python3 -m scudcloud

Troubleshooting

1. Default domain and loading order

You can change the default domain (or the domain loading order) 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 / My team is not saved

For some reason, ScudCloud was not able to create the configuration folder. Please, manually create this folder:

mkdir -p ~/.config/scudcloud/

If it exists and .cfg file is present, try change permissions in config file:

chmod -R 0755 ~/.config/scudcloud/scudcloud.cfg

5. How to start ScudCloud minimized?

You can start ScudCloud minized to tray with:

scudcloud --minimized=True

6. 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

7. No icon in systray/notification area

Make sure that File > Close to Tray is checked.

License

ScudCloud is is released under the MIT License.