Private, fast, and local desktop viewer and search engine for Slack export archives.
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+(Go1.27recommended). - Node.js: Node.js LTS (
>=22.x) andnpm. - Wails v2 CLI: Install globally using
go install:Make surego install github.com/wailsapp/wails/v2/cmd/wails@latest
$(go env GOPATH)/binis in your shell'sPATH: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) |