Slack Export Archive Viewer
Project description
# Slack Export Viewer
[![Build Status](https://travis-ci.org/hfaran/slack-export-viewer.svg?branch=master)](https://travis-ci.org/hfaran/slack-export-viewer)
[![PyPI version](https://badge.fury.io/py/slack-export-viewer.svg)](http://badge.fury.io/py/slack-export-viewer)
A Slack Export archive viewer that allows you to easily view and share your
Slack team's export (instead of having to dive into hundreds of JSON files).
![Preview](screenshot.png)
## Contents
* [Overview](#overview)
* [Installation](#installation)
* [Usage](#usage)
* [Acknowledgements](#acknowledgements)
## Overview
`slack-export-viewer` is useful for small teams on a free Slack plan (limited to 10,000 messages) who overrun their budget and ocassionally need a nice interface to refer back to previous messages. You get a web interface to easily scroll through all channels in the export without having to look at individual JSON files per channel per day.
`slack-export-viewer` can be used locally on one machine for yourself to explore an export or it can be run on a headless server (as it is a Flask web app) if you also want to serve the content to the rest of your team.
## Installation
I recommend [`pipsi`](https://github.com/mitsuhiko/pipsi) for a nice
isolated install.
```bash
pipsi install slack-export-viewer
```
Or just feel free to use `pip` as you like.
```bash
pip install slack-export-viewer
```
`slack-export-viewer` will be installed as an entry-point; run from anywhere.
```bash
$ slack-export-viewer --help
Usage: slack-export-viewer [OPTIONS]
Options:
-p, --port INTEGER Host port to serve your content on
-z, --archive PATH Path to your Slack export archive (.zip file or directory)
[required]
-I, --ip TEXT Host IP to serve your content on
--no-browser If you do not want a browser to open automatically, set
this.
--debug
--help Show this message and exit.
```
## Usage
### 1) Grab your Slack team's export
* Visit [https://my.slack.com/services/export](https://my.slack.com/services/export)
* Create an export
* Wait for it to complete
* Refresh the page and download the export (.zip file) into whatever directory
### 2) Point `slack-export-viewer` to it
Point slack-export-viewer to the .zip file and let it do its magic
```bash
slack-export-viewer -z /path/to/export/zip
```
If everything went well, your archive will have been extracted, processed, and browser window will have opened showing your *#general* channel from the export.
## CLI
There is now a CLI included as well. Currently the one command you can use is clearing the cache from slack-export-viewer from your %TEMP% directory; see usage:
```
└———→ slack-export-viewer-cli --help
Usage: slack-export-viewer-cli [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
clean Cleans up any temporary files (including...
```
### Examples
```
┌— hamza@AURORAONE C:\Users\hamza
└———→ slack-export-viewer-cli clean
Run with -w to remove C:\Users\hamza\AppData\Local\Temp\_slackviewer
┌— hamza@AURORAONE C:\Users\hamza
└———→ slack-export-viewer-cli clean -w
Removing C:\Users\hamza\AppData\Local\Temp\_slackviewer...
```
## Acknowledgements
Credit to Pieter Levels whose [blog post](https://levels.io/slack-export-to-html/) and PHP script I used as a jumping off point for this.
### Improvements over Pieter's script
`slack-export-viewer` is similar in core functionality but adds several things on top to make it nicer to use:
* An installable application
* Automated archive extraction and retention
* A Slack-like sidebar that lets you switch channels easily
* Much more "sophisticated" rendering of messages
* A Flask server which lets you serve the archive contents as opposed to a PHP script which does static file generation
[![Build Status](https://travis-ci.org/hfaran/slack-export-viewer.svg?branch=master)](https://travis-ci.org/hfaran/slack-export-viewer)
[![PyPI version](https://badge.fury.io/py/slack-export-viewer.svg)](http://badge.fury.io/py/slack-export-viewer)
A Slack Export archive viewer that allows you to easily view and share your
Slack team's export (instead of having to dive into hundreds of JSON files).
![Preview](screenshot.png)
## Contents
* [Overview](#overview)
* [Installation](#installation)
* [Usage](#usage)
* [Acknowledgements](#acknowledgements)
## Overview
`slack-export-viewer` is useful for small teams on a free Slack plan (limited to 10,000 messages) who overrun their budget and ocassionally need a nice interface to refer back to previous messages. You get a web interface to easily scroll through all channels in the export without having to look at individual JSON files per channel per day.
`slack-export-viewer` can be used locally on one machine for yourself to explore an export or it can be run on a headless server (as it is a Flask web app) if you also want to serve the content to the rest of your team.
## Installation
I recommend [`pipsi`](https://github.com/mitsuhiko/pipsi) for a nice
isolated install.
```bash
pipsi install slack-export-viewer
```
Or just feel free to use `pip` as you like.
```bash
pip install slack-export-viewer
```
`slack-export-viewer` will be installed as an entry-point; run from anywhere.
```bash
$ slack-export-viewer --help
Usage: slack-export-viewer [OPTIONS]
Options:
-p, --port INTEGER Host port to serve your content on
-z, --archive PATH Path to your Slack export archive (.zip file or directory)
[required]
-I, --ip TEXT Host IP to serve your content on
--no-browser If you do not want a browser to open automatically, set
this.
--debug
--help Show this message and exit.
```
## Usage
### 1) Grab your Slack team's export
* Visit [https://my.slack.com/services/export](https://my.slack.com/services/export)
* Create an export
* Wait for it to complete
* Refresh the page and download the export (.zip file) into whatever directory
### 2) Point `slack-export-viewer` to it
Point slack-export-viewer to the .zip file and let it do its magic
```bash
slack-export-viewer -z /path/to/export/zip
```
If everything went well, your archive will have been extracted, processed, and browser window will have opened showing your *#general* channel from the export.
## CLI
There is now a CLI included as well. Currently the one command you can use is clearing the cache from slack-export-viewer from your %TEMP% directory; see usage:
```
└———→ slack-export-viewer-cli --help
Usage: slack-export-viewer-cli [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
clean Cleans up any temporary files (including...
```
### Examples
```
┌— hamza@AURORAONE C:\Users\hamza
└———→ slack-export-viewer-cli clean
Run with -w to remove C:\Users\hamza\AppData\Local\Temp\_slackviewer
┌— hamza@AURORAONE C:\Users\hamza
└———→ slack-export-viewer-cli clean -w
Removing C:\Users\hamza\AppData\Local\Temp\_slackviewer...
```
## Acknowledgements
Credit to Pieter Levels whose [blog post](https://levels.io/slack-export-to-html/) and PHP script I used as a jumping off point for this.
### Improvements over Pieter's script
`slack-export-viewer` is similar in core functionality but adds several things on top to make it nicer to use:
* An installable application
* Automated archive extraction and retention
* A Slack-like sidebar that lets you switch channels easily
* Much more "sophisticated" rendering of messages
* A Flask server which lets you serve the archive contents as opposed to a PHP script which does static file generation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
slack-export-viewer-0.8.2.tar.gz
(18.2 kB
view hashes)
Built Distribution
Close
Hashes for slack-export-viewer-0.8.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 61554a837cc895d7a7a547b1ae1154975358daa0c1818b4b2cd74b6ac389fc7c |
|
MD5 | 51fbc8b629c28cbfe001ab81478671e9 |
|
BLAKE2b-256 | 7b37ca8ae965bd4ca410c227937e90a7d3ddadc52dc38b3adda99c039d8b3e93 |
Close
Hashes for slack_export_viewer-0.8.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bf196982ed93f25f851d62726ef0922e72f9a5ff08f011027db59852ecfef77e |
|
MD5 | a9e52ee4f12c957d9761ab430d4bf077 |
|
BLAKE2b-256 | aa48490e3968d74b914e5518d0ae0ba26388f98ad04aae0cfd5300cff09a57ca |