slack-downloader

slack-downloader is a tool to download/backup Slack files on a local disk.

The program will download latest files uploaded on Slack, on a configured directory. History of already downloaded files is mantained, in order to avoid duplicate downloads.

Files will be organized inside of a specified directory, with the following form:

<channel_name>/<date>-<filename>_by_<user/uploader>.<ext>

where <date> has the form %Y%m%d_%H%M%S.

This project is a fork of marek/fslack, used for a different purpose.

Requirements

• Slack API Token: Get it from (https://api.slack.com/web)
• Python: The app is written in Python
• python-requests: web request library for Python

Accessing Your Slack Workspace

In order to get your token, you will have to create a new Slack App. You can follow this tutorial. Once you have the app, you have to install it in your workspace. Once it is installed, invite the App's bot into the channels from which you want to download the files. To invite the bot, use \invite @your-app-name as discussed in this question

Installation Instructions

1. Download the Python program:

   wget https://raw.githubusercontent.com/auino/slack-downloader/master/slack-downloader.py
   chmod +x slack-downloader.py
   

2. Open the slack-downloader.py script with a text editor and configure it using a legacy token

3. Optionally, you can add the program to your crontab to automatically check for new shared items on Slack:

   crontab -e
   

4. Now you have to append the following line (press i button to insert data):

   0 * * * * python /directory_path/slack-downloader.py
   

   where /directory_path/ identifies the path of the directory containing the script, while 0 * specifies the program has to be called every hour.

5. Hit :q to close, saving the file

6. Enjoy!

Supporters

• kylevedder for multiple fixes
• nalt for the fix on file downloads
• paloha for resolving API incompatibilities and other fixes

Contacts

You can find me on Twitter as @auino.