disco-reaper/docs/guide.md
2026-03-21 19:43:39 +05:30

37 lines
No EOL
2.4 KiB
Markdown

# Discord Reaper Operations
## 1. Migration & Shuttle Tools
The primary suite of tools for moving data between Discord & Fluxer/Stoat.
* **Shuttle Migration (Direct)**:
Connects directly to Discord and your target platform to migrate categories, channels, roles, and messages in real-time. It uses intelligent mapping to ensure links and mentions work in the new community.
* **Resumed Migration**:
If a large migration is interrupted or hits a rate limit, the Resumed Migration tool uses the local SQLite database to pick up exactly where it left off, skipping messages that have already been transferred.
* **Offline Migration (from Backup)**:
Allows you to migrate data without reaching out to Discord's servers. It uses a previously created local backup as the source, making it the safest and fastest way to migrate if the original Discord server has already been deleted or restricted.
* **Batch Channel Processing**:
Allows you to select up to 50 specific channels or categories to migrate at once. Reaper will process them sequentially to stay within platform rate limits.
---
## 2. Backup & Archiving
Tools for creating and maintaining permanent local copies of your data.
* **Full Server Backup**:
Downloads the entire server structure-including all categories, channels, custom roles, and permission overwrites-along with full message histories and all file attachments into a high-performance SQLite database.
* **Incremental Syncing**:
Scans your existing local backup database and only downloads messages sent since the last run. This is extremely efficient for keeping a continuous archive of active communities.
* **Media Deduplication**:
An background operation that ensures identical file attachments (images, stickers, etc.) are only stored once on your hard drive, even if they appear in multiple messages or channels.
---
## 3. Danger Zone (Advanced Management)
Powerful tools for server cleanup and reset. Use with caution.
* **Server Wipe**:
A high-speed utility that deletes all categories, channels, and custom roles on a target server. This is used to "reset" a community before testing a fresh migration. Requires explicit confirmation.
* **Permission Purge**:
Scans every channel and category on the target server and removes all role and user-specific permission overwrites, restoring the server to its default permission state.
---