GitHub - mestr-io/channelvault: Navigate a Slack export zip file

GitHub

5 min read Original article ↗

ChannelVault Logo

Private, fast, and local desktop viewer and search engine for Slack export archives.

Go Version Wails Version Svelte Version Vite Version SQLite License


Overview

ChannelVault is a modern, cross-platform desktop application built with Wails and Svelte 5. It allows teams, researchers, and individuals to import, browse, search, and preserve Slack workspace export archives (.zip) offline on their local machines.

Zero telemetry, zero cloud dependency — all your communications, channels, threads, and binary attachments are parsed and stored in a private embedded SQLite database on your device.


Features

  • Offline & Private: All data is parsed locally into SQLite with WAL mode. Nothing is sent to third-party servers.
  • Full Workspace Preservation:
    • Public, private, and archived channels
    • User profiles, display names, and avatars
    • Threaded replies and conversations
    • Message edit histories and revisions
    • Reactions and standard Slack emoji rendering
  • Instant Full-Text Search (SQLite FTS5): Blazing-fast BM25 full-text search across all imported messages with keyword highlighting and instant navigation to the source message.
  • Virtualized High-Performance UI: Smoothly scroll through channels containing tens of thousands of messages with keyset pagination and virtualized DOM rendering (virtua).
  • Binary & Media Management: Download and cache workspace images, media, and attachments locally for offline browsing.
  • Import Manager with Checkpointing: Manage multiple workspace imports, rename archives, track import progress, and safely resume interrupted jobs.

Tech Stack

Layer Technology
Desktop Framework Wails v2.17
Backend Go 1.27
Database & Search Embedded SQLite3 with FTS5 full-text search
Frontend UI Svelte 5 (Runes) + TypeScript
Build & Dev Tool Vite 7
Markdown & Emoji Carta + emoji-js
Linter / Formatter Biome

Prerequisites

1. Go, Node.js & Wails CLI

Install the official toolchains:

  • Go: Go 1.26+ (Go 1.27 recommended).
  • Node.js: Node.js LTS (>=22.x) and npm.
  • Wails v2 CLI: Install globally using go install:
    go install github.com/wailsapp/wails/v2/cmd/wails@latest
    Make sure $(go env GOPATH)/bin is in your shell's PATH:
    export PATH="$PATH:$(go env GOPATH)/bin"

Alternative: Using mise

If you manage runtimes with mise, you can pin and install all tools automatically:

mise use -g go@1.27.3
mise use -g node@lts
mise use -g "go:github.com/wailsapp/wails/v2/cmd/wails@v2.17.1"

2. Native System Dependencies

Linux

  • Arch / EndeavourOS:
    sudo pacman -S gtk3 webkit2gtk-4.1 pkgconf gcc
  • Ubuntu / Debian:
    sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev pkg-config gcc

macOS

  • Requires Xcode Command Line Tools:

Windows

  • Requires the Microsoft Edge WebView2 runtime (pre-installed on Windows 10/11) and a C compiler (like MinGW-w64 or MSVC).

Development

1. Install Frontend Dependencies

cd frontend && npm install && cd ..

2. Run Live Development Mode

Start the live development environment with hot-reloading (backend + frontend):

(Runs wails dev -tags webkit2_41,fts5)

During development, the frontend dev server is accessible in your browser at http://localhost:34115 with Go bindings available in devtools.

3. Run Backend & Frontend Tests

# Run backend test suite with coverage
make test

# Run frontend type and syntax checks
cd frontend && npm run check

Building for Production

To produce a self-contained, optimized native desktop binary for your current OS:

(Outputs the executable to build/bin/ChannelVault)

Cross-Compilation (Windows from Linux)


Project Structure

├── backend/
│   ├── app/            # Application lifecycle, Wails IPC methods, and changelog
│   ├── app_helpers/    # Logging helpers and custom slog handlers
│   ├── importer/       # Zip parser, checkpointing, and binary downloader
│   ├── models/         # Go struct models for Slack schema and Wails bindings
│   └── repository/     # SQLite database migrations, queries, and FTS5 search
├── frontend/
│   ├── src/
│   │   ├── lib/
│   │   │   ├── components/  # Svelte 5 components (Message, SlackImport, Search, etc.)
│   │   │   └── types.ts     # Frontend TypeScript types
│   │   ├── App.svelte       # Main three-pane desktop layout
│   │   └── main.ts          # Frontend entry point
│   └── wailsjs/             # Auto-generated Wails JS/TS bindings
├── build/                   # Application icons, packaging metadata, and binaries
├── main.go                  # Main entry point and Wails window options
├── Makefile                 # Development, build, and test task targets
└── wails.json               # Wails application configuration

License & Copyright

ChannelVault is open-source software released under the MIT License.

Copyright (c) mestr.io (info@mestr.io)

Third-Party Software & Attributions

ChannelVault bundles and relies on open-source libraries and assets. We gratefully acknowledge the following projects and their copyright holders:

Backend Libraries (Go)

Library License Copyright
Wails MIT Copyright (c) 2018-present Lea Anthony & Wails Contributors
go-sqlite3 MIT Copyright (c) 2014 Yasuhiro Matsumoto
xdg MIT Copyright (c) 2018-present Adrian Rostovsky
testify MIT Copyright (c) 2012-present Mat Ryer, Tyler Bunnell and contributors
golang.org/x/net BSD-3-Clause Copyright (c) 2009 The Go Authors

Frontend Libraries (JavaScript / TypeScript)

Library License Copyright
Svelte MIT Copyright (c) 2016-present Svelte Contributors
Vite MIT Copyright (c) 2019-present Evan You & Vite Contributors
virtua MIT Copyright (c) 2023-present inokawa
carta-md MIT Copyright (c) 2023-present BearToCode
isomorphic-dompurify / DOMPurify MIT / Apache-2.0 Copyright (c) 2020-present Konstantin Komelin / Copyright (c) 2014-present Cure53
emoji-js MIT Copyright (c) 2014-present Cal Henderson
svelte-splitpanes MIT Copyright (c) 2023-present Olivier Refalo
Biome MIT / Apache-2.0 Copyright (c) 2023-present Biome Authors & Emanuele Stoppa
TypeScript Apache-2.0 Copyright (c) Microsoft Corporation
tslib 0BSD Copyright (c) Microsoft Corporation

Fonts & Assets

Asset License Copyright
Nunito Font SIL Open Font License 1.1 Copyright (c) 2016 The Nunito Project Authors (contact@sansoxygen.com)