Sapper

A desktop application for viewing and managing Discord conversation exports. Built with Tauri, React, and Rust.

Overview

A fast, searchable interface for exported Discord Chats if you're looking for a simple way to keep and manage memories.

The design for this app promises to:

1. Never touch or modify your chats -- even if it messes up, the originals stay intact
2. Keep copies of your chats and assets
3. Be easy to use -- similar to Discord itself!

Features

• Import Discord Exports: Load JSON conversation files with automatic asset validation
• Full-Text Search: Fast search across all messages using an indexed search system
• Message Virtualization: Efficiently handle large conversations with thousands of messages
• Asset Management: Automatic detection and copying of missing conversation assets (images, attachments)
• Export/Import: Backup and restore all conversations or selected ones
• Themes: Multiple color schemes for message display
• Logging: Comprehensive logging system for debugging with privacy protection

Setup

Simply go to releases and download the latest version! Currently only Windows 10/11 is supported.

Installation (for nerds)

Prerequisites

• Node.js 18 or later
• Rust 1.70 or later
• npm or yarn

Build from Source

1. Clone the repository

git clone https://github.com/yourusername/sapper.git
cd sapper

2. Install dependencies

make install
# or: npm install

3. Run in development mode

make dev
# or: npm run tauri dev

4. Build for production

Option A: Unsigned build (for testing)

make build-unsigned

This creates a quick unsigned build in src-tauri/target/release/bundle/. Unsigned builds do NOT support auto-updates.

Option B: Signed build (for distribution)

make build-signed

This creates a signed build with auto-update support. Requires signing key setup (see below).

The compiled application will be in src-tauri/target/release/bundle/nsis/.

Creating Releases

For detailed release instructions, see RELEASE.md.

Prerequisites:

1. Copy .env.example to .env
2. Add your Tauri signing key to .env (see RELEASE.md for key generation)

Quick release commands:

# Build signed app and update manifest
make release

# Build, update manifest, AND create GitHub release (requires gh CLI)
make release-full

Other useful commands:

make help          # Show all available commands
make check-env     # Verify your environment is set up correctly
make clean         # Remove build artifacts

The app includes automatic update functionality - users will be notified when new versions are available.

Usage

1. Export a conversation from Discord using Discord Chat Exporter or similar tools
2. Click "Import Conversation" in Sapper
3. Select the exported JSON file
4. If assets are missing, you'll be prompted to select the folder containing them
5. The conversation will be processed and indexed for searching

Data Storage

Sapper stores all data in ~/.sapper/:

~/.sapper/
├── data/
│   ├── metadata.json          # List of imported conversations
│   ├── config.json            # Application settings
│   └── imports/
│       └── [import-id]/
│           ├── export.json    # Original Discord export
│           ├── chunks/        # Optimized message storage
│           └── search_index/  # Full-text search index
└── logs/
    └── sapper.log            # Application logs (rotated daily)

Application settings are stored in ~/.sapper/data/config.json:

{
  "theme": "default",
  "search_limit": 100,
  "chunk_size": 1000
}

Modify through Settings UI or edit the file directly (requires app restart).

Privacy

Sapper operates entirely locally. No data is transmitted to external servers. Log files sanitize personal information while maintaining debugging utility.

Thanks to Claude for this README ^-^